plucky (3) mbsnrtowcs.3.gz

Provided by: manpages-ro-dev_4.25.1-1_all bug

NUME

       mbsnrtowcs - convertește un șir de caractere multi-octet într-un șir de caractere late

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

SINOPSIS

       #include <wchar.h>

       size_t mbsnrtowcs(wchar_t dest[restrict .len], const char **restrict src,
                         size_t nms, size_t len, mbstate_t *restrict ps);

   Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați feature_test_macros(7)):

       mbsnrtowcs():
           Începând cu glibc 2.10
               _POSIX_C_SOURCE >= 200809L
           Înainte de glibc 2.10:
               _GNU_SOURCE

DESCRIERE

       Funcția  mbsnrtowcs()  este  ca  și funcția mbsnrtowcs(3), cu excepția faptului că numărul de octeți care
       urmează să fie convertiți, începând de la *src, este limitat la cel mult nms octeți.

       Dacă dest nu este NULL, funcția mbsnrtowcs() convertește cel mult nms octeți din șirul  multi-octet  *src
       într-un  șir  de  caractere late care începe la dest. Cel mult len caractere late sunt scrise în dest. Se
       actualizează starea  de  deplasare  *ps.  Conversia  se  realizează  efectiv  prin  apelarea  repetată  a
       mbrtowc(dest, *src, n, ps) unde n este un număr pozitiv, atâta timp cât acest apel reușește, și apoi prin
       incrementarea dest cu unu și *src cu numărul de octeți  consumați.  Conversia  se  poate  opri  din  trei
       motive:

       •  A  fost  întâlnită  o secvență multiocteți nevalidă. În acest caz, *src rămâne indicând către secvența
          multiocteți nevalidă, (size_t) -1 este returnată, iar errno este configurată la EILSEQ.

       •  Limita nms forțează o oprire, sau len caractere de lățime non-L'\0' au fost stocate la dest. În  acest
          caz,  *src  rămâne îndreptat către următoarea secvență multi-octet care urmează să fie convertită, iar
          numărul de caractere late scrise în dest este returnat.

       •  Șirul multioctet a fost complet convertit, inclusiv caracterul lat nul de la sfârșit ('\0'),  ceea  ce
          are ca efect secundar aducerea lui *ps la starea inițială. În acest caz, *src este stabilit la NULL și
          se returnează numărul de caractere late scrise în dest, cu excepția caracterului lat nul de sfârșit.

       În conformitate cu POSIX.1, în cazul în care  memoria  tampon  de  intrare  se  termină  cu  un  caracter
       incomplet,  nu este specificat dacă conversia se oprește la sfârșitul caracterului anterior (dacă există)
       sau la sfârșitul memoriei tampon de intrare. Implementarea glibc adoptă primul comportament.

       Dacă dest este NULL, len este ignorat, iar conversia se desfășoară ca mai sus, cu excepția faptului că nu
       se scriu în memorie caracterele late convertite și că nu există o limită de lungime a destinației.

       În ambele cazuri de mai sus, dacă ps este NULL, se utilizează în schimb o stare statică anonimă cunoscută
       numai de funcția mbsnrtowcs().

       Programatorul trebuie să se asigure că există spațiu pentru cel puțin len caractere la dest.

VALOAREA RETURNATĂ

       Funcția mbsnrtowcs() returnează numărul de caractere late care alcătuiesc partea convertită a șirului  de
       caractere  late,  fără  a  include  caracterul  lat  de  sfârșit nul. În cazul în care a fost întâlnită o
       secvență multi-octet nevalidă, se returnează (size_t) -1, iar errno este configurată la EILSEQ.

ATRIBUTE

       Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

       ┌─────────────┬───────────────────┬──────────────────────────────────────────────────────────────────────┐
       │InterfațăAtributValoare                                                              │
       ├─────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────┤
       │mbsnrtowcs() │ Siguranța firelor │ MT-Unsafe race:mbsnrtowcs/!ps                                        │
       └─────────────┴───────────────────┴──────────────────────────────────────────────────────────────────────┘

STANDARDE

       POSIX.1-2008.

NOTE

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

       Transmiterea lui NULL ca ps nu este sigură pentru execuția cu mai multe fire.

CONSULTAȚI ȘI

       iconv(3), mbrtowc(3), mbsinit(3), mbsrtowcs(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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.