NUME

       wcstombs - convertește un șir de caractere late într-un șir multi-octet

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

SINOPSIS

       #include <stdlib.h>

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

DESCRIERE

       Dacă  dest  nu  este  NULL, funcția wcstombs() convertește șirul de caractere late src într-un șir de mai
       mulți octeți care începe la dest. În dest se scriu cel mult n octeți. Secvența de  caractere  plasate  în
       dest începe în starea inițială de conversie. Conversia se poate opri din trei motive:

       •  A  fost  întâlnit  un  caracter lat care nu poate fi reprezentat ca o secvență de mai mulți octeți (în
          conformitate cu configurația regională curentă).  În acest caz, se returnează (size_t) -1.

       •  Limita de lungime forțează o oprire. În acest caz, se returnează numărul de octeți scriși în dest, dar
          se pierde starea de conversie din acest punct.

       •  Șirul de caractere late a fost complet convertit, inclusiv caracterul lat nul de sfârșit  (L'\0').  În
          acest  caz,  conversia  se  încheie  în  starea inițială de conversie. Se returnează numărul de octeți
          scriși în dest, excluzând octetul nul de sfârșit (L'\0').

       Programatorul trebuie să se asigure că există spațiu pentru cel puțin n octeți la dest.

       Dacă dest este NULL, n este ignorat, iar conversia decurge ca mai sus, cu excepția  faptului  că  octeții
       convertiți nu sunt scriși în memorie și nu există o limită de lungime.

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

VALOAREA RETURNATĂ

       Funcția wcstombs() returnează numărul de octeți care alcătuiesc partea convertită a unei secvențe de  mai
       mulți  octeți,  fără a include octetul nul de terminare. În cazul în care a fost întâlnit un caracter lat
       care nu a putut fi convertit, se returnează (size_t) -1.

ATRIBUTE

       Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).
       ┌─────────────────────────────────────────────────────────────────────────┬───────────────────┬─────────┐
       │ Interfață                                                               │ Atribut           │ Valoare │
       ├─────────────────────────────────────────────────────────────────────────┼───────────────────┼─────────┤
       │ wcstombs()                                                              │ Siguranța firelor │ MT-Safe │
       └─────────────────────────────────────────────────────────────────────────┴───────────────────┴─────────┘

VERSIUNI

       Funcția wcsrtombs(3) oferă o interfață mai bună 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 regională curentă.

CONSULTAȚI ȘI

       mblen(3), mbstowcs(3), mbtowc(3), wcsrtombs(3), wctomb(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                                      wcstombs(3)