mbsnrtowcs(3)              Library Functions Manual              mbsnrtowcs(3)

NUME
       mbsnrtowcs - converte<?>te un <?>ir de caractere multi-octet intr-un
       <?>ir de caractere late

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <wchar.h>

       size_t mbsnrtowcs(wchar_t dest[restrict .len], const char **restrict src,
                         size_t nms, size_t len, mbstate_t *restrict ps);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       mbsnrtowcs():
           Incepand cu glibc 2.10
               _POSIX_C_SOURCE >= 200809L
           Inainte de glibc 2.10:
               _GNU_SOURCE

DESCRIERE
       Func<?>ia mbsnrtowcs() este ca <?>i func<?>ia mbsnrtowcs(3), cu
       excep<?>ia faptului ca numarul de octe<?>i care urmeaza sa fie
       converti<?>i, incepand de la *src, este limitat la cel mult nms
       octe<?>i.

       Daca dest nu este NULL, func<?>ia mbsnrtowcs() converte<?>te cel mult
       nms octe<?>i din <?>irul multi-octet *src intr-un <?>ir de caractere
       late care incepe la dest.  Cel mult len caractere late sunt scrise in
       dest.  Se actualizeaza starea de deplasare *ps.  Conversia se
       realizeaza efectiv prin apelarea repetata a mbrtowc(dest, *src, n, ps)
       unde n este un numar pozitiv, atata timp cat acest apel reu<?>e<?>te,
       <?>i apoi prin incrementarea dest cu unu <?>i *src cu numarul de
       octe<?>i consuma<?>i.  Conversia se poate opri din trei motive:

       o  A fost intalnita o secven<?>a multiocte<?>i nevalida. In acest caz,
          *src ramane indicand catre secven<?>a multiocte<?>i nevalida,
          (size_t) -1 este returnata, iar errno este configurata la EILSEQ.

       o  Limita nms for<?>eaza o oprire, sau len caractere de la<?>ime
          non-L'\0' au fost stocate la dest.  In acest caz, *src ramane
          indreptat catre urmatoarea secven<?>a multi-octet care urmeaza sa
          fie convertita, iar numarul de caractere late scrise in dest este
          returnat.

       o  <?>irul multioctet a fost complet convertit, inclusiv caracterul lat
          nul de la sfar<?>it ('\0'), ceea ce are ca efect secundar aducerea
          lui *ps la starea ini<?>iala. In acest caz, *src este stabilit la
          NULL <?>i se returneaza numarul de caractere late scrise in dest, cu
          excep<?>ia caracterului lat nul de sfar<?>it.

       In conformitate cu POSIX.1, in cazul in care memoria tampon de intrare
       se termina cu un caracter incomplet, nu este specificat daca conversia
       se opre<?>te la sfar<?>itul caracterului anterior (daca exista) sau la
       sfar<?>itul memoriei tampon de intrare. Implementarea glibc adopta
       primul comportament.

       Daca dest este NULL, len este ignorat, iar conversia se desfa<?>oara ca
       mai sus, cu excep<?>ia faptului ca nu se scriu in memorie caracterele
       late convertite <?>i ca nu exista o limita de lungime a destina<?>iei.

       In ambele cazuri de mai sus, daca ps este NULL, se utilizeaza in schimb
       o stare statica anonima cunoscuta numai de func<?>ia mbsnrtowcs().

       Programatorul trebuie sa se asigure ca exista spa<?>iu pentru cel
       pu<?>in len caractere la dest.

VALOAREA RETURNATA
       Func<?>ia mbsnrtowcs() returneaza numarul de caractere late care
       alcatuiesc partea convertita a <?>irului de caractere late, fara a
       include caracterul lat de sfar<?>it nul.  In cazul in care a fost
       intalnita o secven<?>a multi-octet nevalida, se returneaza (size_t) -1,
       iar errno este configurata la EILSEQ.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +-------------+---------------------+----------------------------------+
       |Interfa<?>a  | Atribut             | Valoare                          |
       +-------------+---------------------+----------------------------------+
       |mbsnrtowcs() | Siguran<?>a firelor | MT-Unsafe race:mbsnrtowcs/!ps    |
       +-------------+---------------------+----------------------------------+
STANDARDE
       POSIX.1-2008.

NOTE
       Comportamentul lui mbsnrtowcsr() depinde de categoria LC_CTYPE din
       configura<?>ia regionala curenta.

       Transmiterea lui NULL ca ps nu este sigura pentru execu<?>ia cu mai
       multe fire.

CONSULTA<?>I <?>I
       iconv(3), mbrtowc(3), mbsinit(3), mbsrtowcs(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                 mbsnrtowcs(3)