wcsrtombs(3)               Library Functions Manual               wcsrtombs(3)

NUME
       wcsrtombs - converte<?>te un <?>ir de caractere late intr-un <?>ir
       multi-octet

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <wchar.h>

       size_t wcsrtombs(size_t size;
                        char dest[restrict size], const wchar_t **restrict src,
                        size_t size, mbstate_t *restrict ps);

DESCRIERE
       Daca dest nu este NULL, func<?>ia wcsrtombs() converte<?>te <?>irul de
       caractere late *src intr-un <?>ir multi-octet care incepe la dest. In
       dest se scriu cel mult size octe<?>i. Se actualizeaza starea de
       conversie *ps. Conversia se realizeaza efectiv prin apelarea repetata a
       wcrtomb(dest, *src, ps), atata timp cat acest apel reu<?>e<?>te, iar
       apoi se incrementeaza dest cu numarul de octe<?>i scri<?>i <?>i *src cu
       unu. Conversia se poate opri din trei motive:

       o  A fost intalnit un caracter lat care nu poate fi reprezentat ca o
          secven<?>a de mai mul<?>i octe<?>i (in conformitate cu
          configura<?>ia regionala curenta). In acest caz, *src ramane
          indreptat catre caracterul lat nevalid, se returneaza (size_t) -1,
          iar errno este configurata la EILSEQ.

       o  Limita de dimensiune for<?>eaza o oprire. In acest caz, *src ramane
          indreptat catre urmatorul caracter lat care urmeaza sa fie
          convertit, iar numarul de octe<?>i scris in dest este returnat.

       o  <?>irul de caractere late a fost complet convertit, inclusiv
          caracterul lat nul de sfar<?>it (L'\0'), ceea ce are ca efect
          secundar aducerea lui *ps la starea ini<?>iala. In acest caz, *src
          este fixat la NULL <?>i se returneaza numarul de octe<?>i scri<?>i
          in dest, excluzand octetul nul de sfar<?>it (L'\0').

       Daca dest este NULL, size este ignorata, iar conversia se desfa<?>oara
       ca mai sus, cu excep<?>ia faptului ca octe<?>ii converti<?>i nu sunt
       scri<?>i in memorie <?>i ca nu exista o limita de dimensiune.

       In ambele cazuri de mai sus, daca ps este NULL, se utilizeaza in schimb
       o stare statica anonima cunoscuta doar de func<?>ia wcsrtombs().

       Programatorul trebuie sa se asigure ca exista spa<?>iu pentru cel
       pu<?>in size octe<?>i la dest.

VALOAREA RETURNATA
       Func<?>ia wcsrtombs() returneaza numarul de octe<?>i care alcatuiesc
       partea convertita a secven<?>ei multi-octet, fara a include octetul nul
       de terminare. In cazul in care a fost intalnit un caracter lat care nu
       a putut fi convertit, se returneaza (size_t) -1, iar errno este
       configurata la EILSEQ.

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

       +------------+---------------------+-----------------------------------+
       |Interfa<?>a | Atribut             | Valoare                           |
       +------------+---------------------+-----------------------------------+
       |wcsrtombs() | Siguran<?>a firelor | MT-Unsafe race:wcsrtombs/!ps      |
       +------------+---------------------+-----------------------------------+
STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C99.

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

       Transmiterea lui NULL ca ps nu este sigura pentru execu<?>ia cu mai
       multe fire.

CONSULTA<?>I <?>I
       iconv(3), mbsinit(3), wcrtomb(3), wcsnrtombs(3), wcstombs(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.15   28 iunie 2025                    wcsrtombs(3)