Man page - wcstombs(3)

Packages contains this manual

Available languages:

en fr es ja ru ro de

Manual

wcstombs

NUME
BIBLIOTECA
SINOPSIS
DESCRIERE
VALOAREA RETURNATĂ
ATRIBUTE
VERSIUNI
STANDARDE
ISTORIC
NOTE
CONSULTAȚI ȘI
TRADUCERE

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

Image grohtml-675845-1.png

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 .