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).

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 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.