NUME

       wcrtomb - convertește un caracter lat într-o secvență multi-octet

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

SINOPSIS

       #include <wchar.h>

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

DESCRIERE

       Principalul  caz pentru această funcție este atunci când s nu este NULL și wc nu este un caracter lat nul
       (L'\0').  În acest caz, funcția wcrtomb() convertește caracterul lat wc în reprezentarea  sa  multi-octet
       și  îl  stochează  la  începutul  matricei  de  caractere  indicată de s.  Aceasta actualizează starea de
       conversie *ps și returnează lungimea reprezentării multi-octet menționate, adică numărul de octeți scriși
       în s.

       Un caz diferit este atunci când s nu este NULL, dar wc este un caracter lat nul (L'\0').  În  acest  caz,
       funcția  wcrtomb() stochează în matricea de caractere indicată de s secvența de conversie necesară pentru
       a aduce *ps înapoi la starea inițială, urmată de un octet '\0'.  Actualizează  starea  de  conversie  *ps
       (adică  o aduce în starea inițială) și returnează lungimea secvenței de deplasare plus unu, adică numărul
       de octeți scriși în s.

       Un al treilea caz este atunci când s este NULL.  În acest caz, wc este ignorat,  iar  funcția  returnează
       efectiv

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

       unde buf este un spațiu tampon intern (de memorie) anonim.

       În  toate  cazurile  de  mai  sus, în cazul în care ps este NULL, se utilizează în schimb o stare statică
       anonimă cunoscută doar de funcția wcrtomb().

VALOAREA RETURNATĂ

       Funcția wcrtomb() returnează numărul de octeți care au fost sau ar fi fost scriși în matricea  de  octeți
       la s.  Dacă wc nu poate fi reprezentat ca o secvență de mai mulți octeți (în conformitate cu configurația
       regională curentă), 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ță                                            │ 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 regională curentă.

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

CONSULTAȚI ȘI

       mbsinit(3), wcsrtombs(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.

Pagini de manual de Linux 6.8                      2 mai 2024                                         wcrtomb(3)