NUME

       mbtowc - convertește o secvență multioctet într-un caracter lat

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

SINOPSIS

       #include <stdlib.h>

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

DESCRIERE

       Cazul principal pentru această funcție este atunci când s nu este NULL și pwc nu este NULL. În acest caz,
       funcția  mbtowc()  inspectează cel mult n octeți din șirul multioctet începând de la s, extrage următorul
       caracter multioctet complet, îl convertește într-un  caracter  lat  și  îl  stochează  la  *pwc.  Aceasta
       actualizează  o stare de conversie internă cunoscută numai de funcția mbtowc(). Dacă s nu indică un octet
       nul ('\0'), se returnează numărul de octeți care au fost consumați din s, în caz contrar se returnează 0.

       În cazul în care n octeți care încep la s nu conțin un caracter multioctet  complet  sau  dacă  conțin  o
       secvență  multioctet  nevalidă,  mbtowc()  returnează  -1.  Acest lucru se poate întâmpla chiar dacă n >=
       MB_CUR_MAX, în cazul în care șirul multioctet conține secvențe de deplasare redundante.

       Un caz diferit este atunci când s nu este NULL, dar pwc este NULL. În  acest  caz,  funcția  mbtowc()  se
       comportă ca mai sus, cu excepția faptului că nu stochează în memorie caracterul lat convertit.

       Un  al  treilea  caz este atunci când s este NULL. În acest caz, pwc și n sunt ignorate. Funcția mbtowc()
       restabilește starea de conversie, cunoscută doar de această funcție, la starea inițială și returnează  un
       număr  diferit  de  zero dacă codificarea are o stare de deplasare non-trivială sau zero dacă codificarea
       este fără stare.

VALOAREA RETURNATĂ

       Dacă s nu este NULL, funcția mbtowc() returnează numărul de octeți consumați începând de la s, sau 0 dacă
       s indică un octet null, sau -1 în caz de eșec.

       Dacă s este NULL, funcția mbtowc() returnează un număr diferit de zero dacă codificarea are  o  stare  de
       conversie non-trivială sau zero dacă codificarea este fără stare.

ATRIBUTE

       Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).
       ┌──────────────────────────────────────────────────────────────────┬───────────────────┬────────────────┐
       │ Interfață                                                        │ Atribut           │ Valoare        │
       ├──────────────────────────────────────────────────────────────────┼───────────────────┼────────────────┤
       │ mbtowc()                                                         │ Siguranța firelor │ MT-Unsafe race │
       └──────────────────────────────────────────────────────────────────┴───────────────────┴────────────────┘

VERSIUNI

       Această  funcție  nu  este  sigură  pentru  mai multe fire. Funcția mbrtowc(3) oferă o interfață mai bună
       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 regională curentă.

CONSULTAȚI ȘI

       MB_CUR_MAX(3), mblen(3), mbrtowc(3), mbstowcs(3), wcstombs(3), wctomb(3)

TRADUCERE

       Traducerea   în   limba   română   a   acestui   manual   a   fost   făcută   de   Remus-Gabriel    Chelu
       <remusgabriel.chelu@disroot.org>

       Această  traducere  este  documentație  gratuită;  citiți  Licența publică generală GNU Versiunea 3 sau o
       versiune  ulterioară  cu  privire  la  condiții  privind  drepturile  de  autor.   NU  se   asumă   NICIO
       RESPONSABILITATE.

       Dacă  găsiți  erori  în  traducerea  acestui manual, vă rugăm să trimiteți un e-mail la translation-team-
       ro@lists.sourceforge.net.

Pagini de manual de Linux 6.9.1                   15 iunie 2024                                        mbtowc(3)