.\" -*- 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 mbtowc 3 "2 mai 2024" "Pagini de manual de Linux 6.8" 
.SH NUME
mbtowc \- convertește o secvență multioctet într\-un caracter lat
.SH BIBLIOTECA
Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <stdlib.h>\fP
.P
\fBint mbtowc(wchar_t *restrict \fP\fIpwc\fP\fB, const char \fP\fIs\fP\fB[restrict .\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB);\fP
.fi
.SH DESCRIERE
Cazul principal pentru această funcție este atunci când \fIs\fP nu este NULL și
\fIpwc\fP nu este NULL.  În acest caz, funcția \fBmbtowc\fP() inspectează cel mult
\fIn\fP octeți din șirul multioctet începând de la \fIs\fP, extrage următorul
caracter multioctet complet, îl convertește într\-un caracter lat și îl
stochează la \fI*pwc\fP.  Aceasta actualizează o stare de conversie internă
cunoscută numai de funcția \fBmbtowc\fP().  Dacă \fIs\fP nu indică un octet nul
(\[aq]\e0\[aq]), se returnează numărul de octeți care au fost consumați din
\fIs\fP, în caz contrar se returnează 0.
.P
În cazul în care \fIn\fP octeți care încep la \fIs\fP nu conțin un caracter
multioctet complet sau dacă conțin o secvență multioctet nevalidă,
\fBmbtowc\fP() returnează \-1.  Acest lucru se poate întâmpla chiar dacă \fIn\fP
>= \fIMB_CUR_MAX\fP, în cazul în care șirul multioctet conține secvențe de
deplasare redundante.
.P
Un caz diferit este atunci când \fIs\fP nu este NULL, dar \fIpwc\fP este NULL.  În
acest caz, funcția \fBmbtowc\fP() se comportă ca mai sus, cu excepția faptului
că nu stochează în memorie caracterul lat convertit.
.P
.\" The Dinkumware doc and the Single UNIX specification say this, but
.\" glibc doesn't implement this.
Un al treilea caz este atunci când \fIs\fP este NULL.  În acest caz, \fIpwc\fP și
\fIn\fP sunt ignorate.  Funcția \fBmbtowc\fP() restabilește starea de conversie,
cunoscută doar de această funcție, la starea inițială și returnează un număr
diferit de zero dacă codificarea are o stare de deplasare non\-trivială sau
zero dacă codificarea este fără stare.
.SH "VALOAREA RETURNATĂ"
Dacă \fIs\fP nu este NULL, funcția \fBmbtowc\fP() returnează numărul de octeți
consumați începând de la \fIs\fP, sau 0 dacă \fIs\fP indică un octet null, sau \-1
în caz de eșec.
.P
Dacă \fIs\fP este NULL, funcția \fBmbtowc\fP() returnează un număr diferit de zero
dacă codificarea are o stare de conversie non\-trivială sau zero dacă
codificarea este fără stare.
.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
\fBmbtowc\fP()
T}	Siguranța firelor	MT\-Unsafe race
.TE
.SH VERSIUNI
Această funcție nu este sigură pentru mai multe fire.  Funcția \fBmbrtowc\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 \fBmbtowc\fP() depinde de categoria \fBLC_CTYPE\fP din
configurația regională curentă.
.SH "CONSULTAȚI ȘI"
\fBMB_CUR_MAX\fP(3), \fBmblen\fP(3), \fBmbrtowc\fP(3), \fBmbstowcs\fP(3),
\fBwcstombs\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 .