wcrtomb(3)                 Library Functions Manual                 wcrtomb(3)

NUME
       wcrtomb - converte<?>te un caracter lat intr-o secven<?>a multi-octet

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <wchar.h>

       size_t wcrtomb(char *restrict s, wchar_t wc, mbstate_t *restrict ps);

DESCRIERE
       Principalul caz pentru aceasta func<?>ie este atunci cand s nu este
       NULL <?>i wc nu este un caracter lat nul (L'\0').  In acest caz,
       func<?>ia wcrtomb() converte<?>te caracterul lat wc in reprezentarea sa
       multi-octet <?>i il stocheaza la inceputul matricei de caractere
       indicata de s.  Aceasta actualizeaza starea de conversie *ps <?>i
       returneaza lungimea reprezentarii multi-octet men<?>ionate, adica
       numarul de octe<?>i scri<?>i in s.

       Un caz diferit este atunci cand s nu este NULL, dar wc este un caracter
       lat nul (L'\0').  In acest caz, func<?>ia wcrtomb() stocheaza in
       matricea de caractere indicata de s secven<?>a de conversie necesara
       pentru a aduce *ps inapoi la starea ini<?>iala, urmata de un octet
       '\0'.  Actualizeaza starea de conversie *ps (adica o aduce in starea
       ini<?>iala) <?>i returneaza lungimea secven<?>ei de deplasare plus unu,
       adica numarul de octe<?>i scri<?>i in s.

       Un al treilea caz este atunci cand s este NULL.  In acest caz, wc este
       ignorat, iar func<?>ia returneaza efectiv

           wcrtomb(buf, L'\0', ps)

       unde buf este un spa<?>iu tampon intern (de memorie) anonim.

       In toate cazurile de mai sus, in cazul in care ps este NULL, se
       utilizeaza in schimb o stare statica anonima cunoscuta doar de
       func<?>ia wcrtomb().

VALOAREA RETURNATA
       Func<?>ia wcrtomb() returneaza numarul de octe<?>i care au fost sau ar
       fi fost scri<?>i in matricea de octe<?>i la s.  Daca wc nu poate fi
       reprezentat ca o secven<?>a de mai mul<?>i octe<?>i (in conformitate cu
       configura<?>ia regionala curenta), 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                    |
       +-------------------+---------------------+----------------------------+
       |wcrtomb()          | Siguran<?>a firelor | MT-Unsafe race:wcrtomb/!ps |
       +-------------------+---------------------+----------------------------+
STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C99.

NOTE
       Comportamentul lui wcrtomb() 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
       mbsinit(3), wcsrtombs(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                    wcrtomb(3)