NUME

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

BIBLIOTECA

Biblioteca C standard (libc, -lc)

REZUMAT

#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);

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).

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 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.