.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wcstombs 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" 
.SH NUME
wcstombs \- convertește un șir de caractere late într\-un șir multi\-octet
.SH BIBLIOTECA
Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP)
.SH REZUMAT
.nf
\fB#include <stdlib.h>\fP
.PP
\fBsize_t wcstombs(char \fP\fIdest\fP\fB[restrict .\fP\fIn\fP\fB], const wchar_t *restrict \fP\fIsrc\fP\fB,\fP
\fB                size_t \fP\fIn\fP\fB);\fP
.fi
.SH DESCRIERE
Dacă \fIdest\fP nu este NULL, funcția \fBwcstombs\fP() convertește șirul de
caractere late \fIsrc\fP într\-un șir de mai mulți octeți care începe la
\fIdest\fP.  În \fIdest\fP se scriu cel mult \fIn\fP octeți.  Secvența de caractere
plasate în \fIdest\fP începe în starea inițială de conversie.  Conversia se
poate opri din trei motive:
.IP \[bu] 3
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ă \fI(size_t)\ \-1\fP.
.IP \[bu]
Limita de lungime forțează o oprire.  În acest caz, se returnează numărul de
octeți scriși în \fIdest\fP, dar se pierde starea de conversie din acest punct.
.IP \[bu]
Șirul de caractere late a fost complet convertit, inclusiv caracterul lat
nul de sfârșit (L\[aq]\e0\[aq]).  În acest caz, conversia se încheie în
starea inițială de conversie.  Se returnează numărul de octeți scriși în
\fIdest\fP, excluzând octetul nul de sfârșit (L\[aq]\e0\[aq]).
.PP
Programatorul trebuie să se asigure că există spațiu pentru cel puțin \fIn\fP
octeți la \fIdest\fP.
.PP
Dacă \fIdest\fP este NULL, \fIn\fP 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.
.PP
Pentru a evita cazul 2 de mai sus, programatorul trebuie să se asigure că
\fIn\fP este mai mare sau egal cu \fIwcstombs(NULL,src,0)+1\fP.
.SH "VALOAREA RETURNATĂ"
Funcția \fBwcstombs\fP() 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ă \fI(size_t)\ \-1\fP.
.SH ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfață	Atribut	Valoare
T{
.na
.nh
\fBwcstombs\fP()
T}	Siguranța firelor	MT\-Safe
.TE
.sp 1
.SH VERSIUNI
Funcția \fBwcsrtombs\fP(3) oferă o interfață mai bună pentru aceeași
funcționalitate.
.SH STANDARDE
C11, POSIX.1\-2008.
.SH ISTORIC
POSIX.1\-2001, C99.
.SH NOTE
Comportamentul lui \fBwcstombs\fP() depinde de categoria \fBLC_CTYPE\fP din
configurația regională curentă.
.SH "CONSULTAȚI ȘI"
\fBmblen\fP(3), \fBmbstowcs\fP(3), \fBmbtowc\fP(3), \fBwcsrtombs\fP(3), \fBwctomb\fP(3)
.PP
.SH TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de
Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>
.
.PP
Această traducere este documentație gratuită; citiți
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licența publică generală GNU Versiunea 3
.UE
sau o versiune ulterioară cu privire la condiții privind drepturile de autor.
NU se asumă NICIO RESPONSABILITATE.
.PP
Dacă găsiți erori în traducerea acestui manual,
vă rugăm să trimiteți un e-mail la
.MT translation-team-ro@lists.sourceforge.net
.ME .