.\" -*- 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 wcsnrtombs 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME wcsnrtombs \- 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 \fP .PP \fBsize_t wcsnrtombs(char \fP\fIdest\fP\fB[restrict .\fP\fIlen\fP\fB], const wchar_t **restrict \fP\fIsrc\fP\fB,\fP \fB size_t \fP\fInwc\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 \fBwcsnrtombs\fP(): .nf Începând cu glibc 2.10 _POSIX_C_SOURCE >= 200809L Înainte de glibc 2.10: _GNU_SOURCE .fi .SH DESCRIERE Funcția \fBwcsnrtombs\fP() este ca și funcția \fBwcsrtombs\fP(3), cu excepția faptului că numărul de caractere late care urmează să fie convertite, începând de la \fI*src\fP, este limitat la \fInwc\fP. .PP Dacă \fIdest\fP nu este NULL, funcția \fBwcsnrtombs\fP() convertește cel mult \fInwc\fP caractere late din șirul de caractere late \fI*src\fP într\-un șir multi\-octet care începe la \fIdest\fP. Cel mult \fIlen\fP octeți sunt scriși în \fIdest\fP. Se actualizează starea de conversie \fI*ps\fP. Conversia se realizează efectiv prin apelarea repetată a \fIwcrtomb(dest, *src, ps)\fP, atâta timp cât acest apel reușește, iar apoi se incrementează \fIdest\fP cu numărul de octeți scriși și \fI*src\fP cu unu. 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, \fI*src\fP rămâne îndreptat către caracterul lat nevalid, se returnează \fI(size_t)\ \-1\fP, iar \fIerrno\fP este configurată la \fBEILSEQ\fP. .IP \[bu] Caracterele late \fInwc\fP au fost convertite fără a se întâlni un caracter lat nul (L\[aq]\e0\[aq]) sau limita de lungime forțează o oprire. În acest caz, \fI*src\fP rămâne îndreptat către următorul caracter lat care urmează să fie convertit, iar numărul de octeți scris în \fIdest\fP este returnat. .IP \[bu] Șirul de caractere late a fost complet convertit, inclusiv caracterul lat nul de sfârșit (care are ca efect secundar aducerea lui \fI*ps\fP la starea inițială). În acest caz, \fI*src\fP este setat la NULL, iar numărul de octeți scriși în \fIdest\fP, cu excepția octetului de sfârșit nul (\[aq]\e0\[aq]), este returnat. .PP Dacă \fIdest\fP este NULL, \fIlen\fP este ignorat, iar conversia se desfășoară ca mai sus, cu excepția faptului că octeții convertiți nu sunt scriși în memorie ș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ă doar de funcția \fBwcsnrtombs\fP(). .PP Programatorul trebuie să se asigure că există spațiu pentru cel puțin \fIlen\fP octeți la \fIdest\fP. .SH "VALOAREA RETURNATĂ" Funcția \fBwcsnrtombs\fP() returnează numărul de octeți care alcătuiesc partea convertită a secvenței multibyte, 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, 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 \fBwcsnrtombs\fP() T} Siguranța firelor T{ .na .nh MT\-Unsafe race:wcsnrtombs/!ps T} .TE .sp 1 .SH STANDARDE POSIX.1\-2008. .SH NOTE Comportamentul lui \fBwcsnrtombs\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), \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 . .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 .