.\" -*- 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 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH mbsnrtowcs 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME mbsnrtowcs \- convertește un șir de caractere multi\-octet într\-un șir de caractere late .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .PP \fBsize_t mbsnrtowcs(wchar_t \fP\fIdest\fP\fB[restrict .\fP\fIlen\fP\fB], const char **restrict \fP\fIsrc\fP\fB,\fP \fB size_t \fP\fInms\fP\fB, size_t \fP\fIlen\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP .fi .PP .RS -4 Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați \fBfeature_test_macros\fP(7)): .RE .PP \fBmbsnrtowcs\fP(): .nf Începând cu glibc 2.10 _POSIX_C_SOURCE >= 200809L Înainte de glibc 2.10: _GNU_SOURCE .fi .SH DESCRIERE Funcția \fBmbsnrtowcs\fP() este ca și funcția \fBmbsnrtowcs\fP(3), cu excepția faptului că numărul de octeți care urmează să fie convertiți, începând de la \fI*src\fP, este limitat la cel mult \fInms\fP octeți. .PP Dacă \fIdest\fP nu este NULL, funcția \fBmbsnrtowcs\fP() convertește cel mult \fInms\fP octeți din șirul multi\-octet \fI*src\fP într\-un șir de caractere late care începe la \fIdest\fP. Cel mult \fIlen\fP caractere late sunt scrise în \fIdest\fP. Se actualizează starea de deplasare \fI*ps\fP. Conversia se realizează efectiv prin apelarea repetată a \fImbrtowc(dest, *src, n, ps)\fP unde \fIn\fP este un număr pozitiv, atâta timp cât acest apel reușește, și apoi prin incrementarea \fIdest\fP cu unu și \fI*src\fP cu numărul de octeți consumați. Conversia se poate opri din trei motive: .IP \[bu] 3 A fost întâlnită o secvență multiocteți nevalidă. În acest caz, \fI*src\fP rămâne indicând către secvența multiocteți nevalidă, \fI(size_t)\ \-1\fP este returnată, iar \fIerrno\fP este configurată la \fBEILSEQ\fP. .IP \[bu] Limita \fInms\fP forțează o oprire, sau \fIlen\fP caractere de lățime non\-L\[aq]\e0\[aq] au fost stocate la \fIdest\fP. În acest caz, \fI*src\fP rămâne îndreptat către următoarea secvență multi\-octet care urmează să fie convertită, iar numărul de caractere late scrise în \fIdest\fP este returnat. .IP \[bu] Șirul multioctet a fost complet convertit, inclusiv caracterul lat nul de la sfârșit (\[aq]\e0\[aq]), ceea ce are ca efect secundar aducerea lui \fI*ps\fP la starea inițială. În acest caz, \fI*src\fP este stabilit la NULL și se returnează numărul de caractere late scrise în \fIdest\fP, cu excepția caracterului lat nul de sfârșit. .PP În conformitate cu POSIX.1, în cazul în care memoria tampon de intrare se termină cu un caracter incomplet, nu este specificat dacă conversia se oprește la sfârșitul caracterului anterior (dacă există) sau la sfârșitul memoriei tampon de intrare. Implementarea glibc adoptă primul comportament. .PP Dacă \fIdest\fP este NULL, \fIlen\fP este ignorat, iar conversia se desfășoară ca mai sus, cu excepția faptului că nu se scriu în memorie caracterele late convertite și că nu există o limită de lungime a destinației. .PP În ambele cazuri de mai sus, dacă \fIps\fP este NULL, se utilizează în schimb o stare statică anonimă cunoscută numai de funcția \fBmbsnrtowcs\fP(). .PP Programatorul trebuie să se asigure că există spațiu pentru cel puțin \fIlen\fP caractere la \fIdest\fP. .SH "VALOAREA RETURNATĂ" Funcția \fBmbsnrtowcs\fP() returnează numărul de caractere late care alcătuiesc partea convertită a șirului de caractere late, fără a include caracterul lat de sfârșit nul. În cazul în care a fost întâlnită o secvență multi\-octet nevalidă, 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; lb lb lbx l l l. Interfață Atribut Valoare T{ .na .nh \fBmbsnrtowcs\fP() T} Siguranța firelor T{ .na .nh MT\-Unsafe race:mbsnrtowcs/!ps T} .TE .sp 1 .SH STANDARDE POSIX.1\-2008. .SH NOTE Comportamentul lui \fBmbsnrtowcsr\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" \fBiconv\fP(3), \fBmbrtowc\fP(3), \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 .