mbtowc(3)                  Library Functions Manual                  mbtowc(3)

NUME
       mbtowc - converte<?>te o secven<?>a multioctet intr-un caracter lat

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdlib.h>

       int mbtowc(wchar_t *restrict pwc, const char s[restrict .n], size_t n);

DESCRIERE
       Cazul principal pentru aceasta func<?>ie este atunci cand s nu este
       NULL <?>i pwc nu este NULL.  In acest caz, func<?>ia mbtowc()
       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.  Aceasta actualizeaza o
       stare de conversie interna cunoscuta numai de func<?>ia mbtowc().  Daca
       s nu indica un octet nul ('\0'), se returneaza numarul de octe<?>i care
       au fost consuma<?>i din s, in caz contrar se returneaza 0.

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

       Un caz diferit este atunci cand s nu este NULL, dar pwc este NULL.  In
       acest caz, func<?>ia mbtowc() 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.  Func<?>ia mbtowc() restabile<?>te starea de
       conversie, cunoscuta doar de aceasta func<?>ie, la starea ini<?>iala
       <?>i returneaza un numar diferit de zero daca codificarea are o stare
       de deplasare non-triviala sau zero daca codificarea este fara stare.

VALOAREA RETURNATA
       Daca s nu este NULL, func<?>ia mbtowc() returneaza numarul de octe<?>i
       consuma<?>i incepand de la s, sau 0 daca s indica un octet null, sau -1
       in caz de e<?>ec.

       Daca s este NULL, func<?>ia mbtowc() returneaza un numar diferit de
       zero daca codificarea are o stare de conversie non-triviala sau zero
       daca codificarea este fara stare.

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

       +-------------------------------+---------------------+----------------+
       |Interfa<?>a                    | Atribut             | Valoare        |
       +-------------------------------+---------------------+----------------+
       |mbtowc()                       | Siguran<?>a firelor | MT-Unsafe race |
       +-------------------------------+---------------------+----------------+
VERSIUNI
       Aceasta func<?>ie nu este sigura pentru mai multe fire.  Func<?>ia
       mbrtowc(3) ofera o interfa<?>a mai buna pentru aceea<?>i
       func<?>ionalitate.

STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C99.

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

CONSULTA<?>I <?>I
       MB_CUR_MAX(3), mblen(3), mbrtowc(3), mbstowcs(3), wcstombs(3),
       wctomb(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                     mbtowc(3)