mbrtowc(3)                 Library Functions Manual                 mbrtowc(3)

NUME
       mbrtowc - converte<?>te o secven<?>a multi-octet intr-un caracter lat

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <wchar.h>

       size_t mbrtowc(wchar_t *restrict pwc, const char s[restrict .n],
                      size_t n, mbstate_t *restrict ps);

DESCRIERE
       Cazul principal pentru aceasta func<?>ie este atunci cand s nu este
       NULL <?>i pwc nu este NULL.  In acest caz, func<?>ia mbrtowc()
       inspecteaza cel mult n octe<?>i din <?>irul multioctet incepand de la
       s, extrage urmatorul caracter multioctet complet, il converte<?>te
       intr-un caracter lat <?>i il stocheaza la *pwc.  Se actualizeaza starea
       de conversie *ps.  In cazul in care caracterul lat convertit nu este
       L'\0' (caracterul lat null), se returneaza numarul de octe<?>i care au
       fost consuma<?>i din s.  In cazul in care caracterul lat convertit este
       L'\0', se reini<?>iaza starea de conversie *ps la starea ini<?>iala
       <?>i se returneaza 0.

       In cazul in care n octe<?>i care incep la s nu con<?>in un caracter
       multioctet complet, mbrtowc() returneaza (size_t) -2.  Acest lucru se
       poate intampla chiar daca n >= MB_CUR_MAX, in cazul in care <?>irul
       multioctet con<?>ine secven<?>e de deplasare redundante.

       Daca <?>irul multioctet care incepe la s con<?>ine o secven<?>a
       multioctet nevalida inainte de urmatorul caracter complet, mbrtowc()
       returneaza (size_t) -1 <?>i configureaza errno la EILSEQ.  In acest
       caz, efectele asupra lui *ps sunt nedefinite.

       Un caz diferit este atunci cand s nu este NULL, dar pwc este NULL.  In
       acest caz, func<?>ia mbrtowc() se comporta ca mai sus, cu excep<?>ia
       faptului ca nu stocheaza in memorie caracterul lat convertit.

       Un al treilea caz este atunci cand s este NULL.  In acest caz, pwc <?>i
       n sunt ignorate.  In cazul in care starea de conversie reprezentata de
       *ps denota o conversie incompleta a caracterelor multioctet, func<?>ia
       mbrtowc() returneaza (size_t) -1, stabile<?>te errno la EILSEQ <?>i
       lasa *ps intr-o stare nedefinita.  In caz contrar, func<?>ia mbrtowc()
       plaseaza *ps in starea ini<?>iala <?>i returneaza 0.

       In toate cazurile de mai sus, daca ps este NULL, se folose<?>te in
       schimb o stare statica anonima cunoscuta doar de func<?>ia mbrtowc().
       Daca nu, *ps trebuie sa fie un obiect mbstate_t valid.  Un obiect
       mbstate_t a poate fi ini<?>ializat la starea ini<?>iala prin aducerea
       la zero, de exemplu, folosind

           memset(&a, 0, sizeof(a));

VALOAREA RETURNATA
       Func<?>ia mbrtowc() returneaza numarul de octe<?>i analiza<?>i din
       secven<?>a de mai mul<?>i octe<?>i care incepe la s, daca a fost
       recunoscut un caracter lat care nu este L'\0'.  Aceasta returneaza 0,
       daca a fost recunoscut un caracter lat L'\0'.  Returneaza (size_t) -1
       <?>i configureaza errno la EILSEQ, in cazul in care a fost intalnita o
       secven<?>a multioctet nevalida.  Acesta returneaza (size_t) -2 daca nu
       a putut analiza un caracter multioctet complet, ceea ce inseamna ca n
       ar trebui sa fie marit.

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

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

ISTORIC
       POSIX.1-2001, C99.

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

CONSULTA<?>I <?>I
       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                    mbrtowc(3)