mbsrtowcs(3)               Library Functions Manual               mbsrtowcs(3)

NUME
       mbsrtowcs - converte<?>te un <?>ir de caractere multioctet intr-un
       <?>ir de caractere late (repornibil)

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <wchar.h>

       size_t mbsrtowcs(wchar_t dest[restrict .dsize], const char **restrict src,
                        size_t dsize, mbstate_t *restrict ps);

DESCRIERE
       Daca dest nu este NULL, converte<?>te <?>irul multi-octet *src intr-un
       <?>ir de caractere late care incepe la dest. Cel mult dsize caractere
       late sunt scrise in dest.  Se actualizeaza starea de conversie *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  dsize caractere non-L'\0' late au fost stocate la dest. In acest
          caz, *src ramane indicand urmatoarea secven<?>a multioctet 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 largi scrise in dest,
          cu excep<?>ia caracterului lat nul de sfar<?>it.

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

       In ambele cazuri de mai sus, in cazul in care ps este NULL, se
       utilizeaza in schimb o stare statica anonima cunoscuta doar de
       func<?>ia mbsrtowcs().

       Pentru a evita cazul 2 de mai sus, programatorul trebuie sa se asigure
       ca dsize este mai mare sau egal cu mbsrtowcs(NULL,src,0,ps)+1.

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

       Aceasta func<?>ie este o versiune repornibila a mbstowcs(3).

VALOAREA RETURNATA
       Numarul de caractere late care alcatuiesc partea convertita a <?>irului
       de caractere late, fara a include caracterul lat de incheiere nul. In
       cazul in care a fost intalnita o secven<?>a multioctet 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                           |
       +------------+---------------------+-----------------------------------+
       |mbsrtowcs() | Siguran<?>a firelor | MT-Unsafe race:mbsrtowcs/!ps      |
       +------------+---------------------+-----------------------------------+
STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C99.

NOTE
       Comportamentul lui mbsrtowcs() 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), mbsnrtowcs(3), mbstowcs(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 19 noiembrie 2023                  mbsrtowcs(3)