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.9.1                   15 iunie 2024                                       wcrtomb(3)