wcstombs(3)                Library Functions Manual                wcstombs(3)

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

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdlib.h>

       size_t wcstombs(char dest[restrict .n], const wchar_t *restrict src,
                       size_t n);

DESCRIERE
       Daca dest nu este NULL, func<?>ia wcstombs() converte<?>te <?>irul de
       caractere late src intr-un <?>ir de mai mul<?>i octe<?>i care incepe la
       dest.  In dest se scriu cel mult n octe<?>i.  Secven<?>a de caractere
       plasate in dest incepe in starea ini<?>iala de conversie.  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, se returneaza
          (size_t) -1.

       o  Limita de lungime for<?>eaza o oprire.  In acest caz, se returneaza
          numarul de octe<?>i scri<?>i in dest, dar se pierde starea de
          conversie din acest punct.

       o  <?>irul de caractere late a fost complet convertit, inclusiv
          caracterul lat nul de sfar<?>it (L'\0').  In acest caz, conversia se
          incheie in starea ini<?>iala de conversie.  Se returneaza numarul de
          octe<?>i scri<?>i in dest, excluzand octetul nul de sfar<?>it
          (L'\0').

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

       Daca dest este NULL, n este ignorat, iar conversia decurge ca mai sus,
       cu excep<?>ia faptului ca octe<?>ii converti<?>i nu sunt scri<?>i in
       memorie <?>i nu exista o limita de lungime.

       Pentru a evita cazul 2 de mai sus, programatorul trebuie sa se asigure
       ca n este mai mare sau egal cu wcstombs(NULL,src,0)+1.

VALOAREA RETURNATA
       Func<?>ia wcstombs() returneaza numarul de octe<?>i care alcatuiesc
       partea convertita a unei secven<?>e de mai mul<?>i octe<?>i, 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.

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

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |wcstombs()                            | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
VERSIUNI
       Func<?>ia wcsrtombs(3) ofera o interfa<?>a mai buna pentru aceea<?>i
       func<?>ionalitate.

STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C99.

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

CONSULTA<?>I <?>I
       mblen(3), mbstowcs(3), mbtowc(3), wcsrtombs(3), wctomb(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.06 31 octombrie 2023                   wcstombs(3)