NUME

       mbtowc - convertește o secvență multioctet într-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  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 │
       └──────────────────────────────────────────────────────────────────┴───────────────────┴────────────────┘

STANDARDE

       POSIX.1-2001, POSIX.1-2008, C99.

NOTE

       Comportamentul lui mbtowc() depinde de categoria LC_CTYPE din configurația regională curentă.

       Această  funcție  nu  este  sigură  pentru mai multe fire.  Funcția mbrtowc(3) oferă o interfață mai bună
       pentru aceeași funcționalitate.

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   creată   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.03                  5 februarie 2023                                       mbtowc(3)