.\" -*- 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 wcrtomb 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" 
.SH NUME
wcrtomb \- convertește un caracter lat într\-o secvență multi\-octet
.SH BIBLIOTECA
Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP)
.SH REZUMAT
.nf
\fB#include <wchar.h>\fP
.PP
\fBsize_t wcrtomb(char *restrict \fP\fIs\fP\fB, wchar_t \fP\fIwc\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP
.fi
.SH DESCRIERE
Principalul caz pentru această funcție este atunci când \fIs\fP nu este NULL și
\fIwc\fP nu este un caracter lat nul (L\[aq]\e0\[aq]).  În acest caz, funcția
\fBwcrtomb\fP() convertește caracterul lat \fIwc\fP în reprezentarea sa
multi\-octet și îl stochează la începutul matricei de caractere indicată de
\fIs\fP.  Aceasta actualizează starea de conversie \fI*ps\fP și returnează
lungimea reprezentării multi\-octet menționate, adică numărul de octeți
scriși în \fIs\fP.
.PP
Un caz diferit este atunci când \fIs\fP nu este NULL, dar \fIwc\fP este un
caracter lat nul (L\[aq]\e0\[aq]).  În acest caz, funcția \fBwcrtomb\fP()
stochează în matricea de caractere indicată de \fIs\fP secvența de conversie
necesară pentru a aduce \fI*ps\fP înapoi la starea inițială, urmată de un octet
\[aq]\e0\[aq].  Actualizează starea de conversie \fI*ps\fP (adică o aduce în
starea inițială) și returnează lungimea secvenței de deplasare plus unu,
adică numărul de octeți scriși în \fIs\fP.
.PP
Un al treilea caz este atunci când \fIs\fP este NULL.  În acest caz, \fIwc\fP este
ignorat, iar funcția returnează efectiv
.PP
.in +4n
.EX
wcrtomb(buf, L\[aq]\e0\[aq], ps)
.EE
.in
.PP
unde \fIbuf\fP este un spațiu tampon intern (de memorie) anonim.
.PP
În toate cazurile de mai sus, în cazul în care \fIps\fP este NULL, se
utilizează în schimb o stare statică anonimă cunoscută doar de funcția
\fBwcrtomb\fP().
.SH "VALOAREA RETURNATĂ"
Funcția \fBwcrtomb\fP() returnează numărul de octeți care au fost sau ar fi
fost scriși în matricea de octeți la \fIs\fP.  Dacă \fIwc\fP nu poate fi
reprezentat ca o secvență de mai mulți octeți (în conformitate cu
configurația regională curentă), se returnează \fI(size_t)\ \-1\fP, iar \fIerrno\fP
este configurată la \fBEILSEQ\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
\fBwcrtomb\fP()
T}	Siguranța firelor	MT\-Unsafe race:wcrtomb/!ps
.TE
.sp 1
.SH STANDARDE
C11, POSIX.1\-2008.
.SH ISTORIC
POSIX.1\-2001, C99.
.SH NOTE
Comportamentul lui \fBwcrtomb\fP() depinde de categoria \fBLC_CTYPE\fP din
configurația regională curentă.
.PP
Transmiterea lui NULL ca \fIps\fP nu este sigură pentru execuția cu mai multe
fire.
.SH "CONSULTAȚI ȘI"
\fBmbsinit\fP(3), \fBwcsrtombs\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 .