.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) Bruno Haible .\" .\" 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 mbrtowc 3 "31 octombrie 2023" "Pagini de manual de Linux 6.06" .SH NUME mbrtowc \- convertește o secvență multi\-octet într\-un caracter lat .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .P \fBsize_t mbrtowc(wchar_t *restrict \fP\fIpwc\fP\fB, const char \fP\fIs\fP\fB[restrict .\fP\fIn\fP\fB],\fP \fB size_t \fP\fIn\fP\fB, mbstate_t *restrict \fP\fIps\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 \fBmbrtowc\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. Se actualizează starea de conversie \fI*ps\fP. În cazul în care caracterul lat convertit nu este L\[aq]\e0\[aq] (caracterul lat null), se returnează numărul de octeți care au fost consumați din \fIs\fP. În cazul în care caracterul lat convertit este L\[aq]\e0\[aq], se reinițiază starea de conversie \fI*ps\fP la starea inițială și se returnează 0. .P În cazul în care \fIn\fP octeți care încep la \fIs\fP nu conțin un caracter multioctet complet, \fBmbrtowc\fP() returnează \fI(size_t)\ \-2\fP. 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 Dacă șirul multioctet care începe la \fIs\fP conține o secvență multioctet nevalidă înainte de următorul caracter complet, \fBmbrtowc\fP() returnează \fI(size_t)\ \-1\fP și configurează \fIerrno\fP la \fBEILSEQ\fP. În acest caz, efectele asupra lui \fI*ps\fP sunt nedefinite. .P Un caz diferit este atunci când \fIs\fP nu este NULL, dar \fIpwc\fP este NULL. În acest caz, funcția \fBmbrtowc\fP() se comportă ca mai sus, cu excepția faptului că nu stochează în memorie caracterul lat convertit. .P Un al treilea caz este atunci când \fIs\fP este NULL. În acest caz, \fIpwc\fP și \fIn\fP sunt ignorate. În cazul în care starea de conversie reprezentată de \fI*ps\fP denotă o conversie incompletă a caracterelor multioctet, funcția \fBmbrtowc\fP() returnează \fI(size_t)\ \-1\fP, stabilește \fIerrno\fP la \fBEILSEQ\fP și lasă \fI*ps\fP într\-o stare nedefinită. În caz contrar, funcția \fBmbrtowc\fP() plasează \fI*ps\fP în starea inițială și returnează 0. .P În toate cazurile de mai sus, dacǎ \fIps\fP este NULL, se folosește în schimb o stare statică anonimă cunoscută doar de funcția \fBmbrtowc\fP(). Dacă nu, \fI*ps\fP trebuie să fie un obiect \fImbstate_t\fP valid. Un obiect \fImbstate_t\fP \fIa\fP poate fi inițializat la starea inițială prin aducerea la zero, de exemplu, folosind .P .in +4n .EX memset(&a, 0, sizeof(a)); .EE .in .SH "VALOAREA RETURNATĂ" Funcția \fBmbrtowc\fP() returnează numărul de octeți analizați din secvența de mai mulți octeți care începe la \fIs\fP, dacă a fost recunoscut un caracter lat care nu este L\[aq]\e0\[aq]. Aceasta returnează 0, dacă a fost recunoscut un caracter lat L\[aq]\e0\[aq]. Returnează \fI(size_t)\ \-1\fP și configurează \fIerrno\fP la \fBEILSEQ\fP, în cazul în care a fost întâlnită o secvență multioctet nevalidă. Acesta returnează \fI(size_t)\ \-2\fP dacă nu a putut analiza un caracter multioctet complet, ceea ce înseamnă că \fIn\fP ar trebui să fie mărit. .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 \fBmbrtowc\fP() T} Siguranța firelor MT\-Unsafe race:mbrtowc/!ps .TE .SH STANDARDE C11, POSIX.1\-2008. .SH ISTORIC POSIX.1\-2001, C99. .SH NOTE Comportamentul lui \fBmbrtowc\fP() depinde de categoria \fBLC_CTYPE\fP din configurația regională curentă. .SH "CONSULTAȚI ȘI" \fBmbsinit\fP(3), \fBmbsrtowcs\fP(3) .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .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 .