NUME

       wcstombs - convertește un șir de caractere late într-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

       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 │
       └───────────────────────────────────────────────────────────┴───────────────────┴─────────┘

STANDARDE

       POSIX.1-2001, POSIX.1-2008, C99.

NOTE

       Comportamentul lui wcstombs() depinde de categoria  LC_CTYPE  din  configurația  regională
       curentă.

       Funcția wcsrtombs(3) oferă o interfață mai bună pentru aceeași funcționalitate.

CONSULTAȚI ȘI

       mblen(3), mbstowcs(3), mbtowc(3), wcsrtombs(3), wctomb(3)

TRADUCERE

       Traducerea  în  limba  română  a  acestui  manual  a  fost  creată  de Remus-Gabriel Chelu
       <remusgabriel.chelu@disroot.org>

       Această  traducere  este  documentație  gratuită;  citiți  Licența  publică  generală  GNU
       Versiunea  3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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⟩.