.\" -*- 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 wprintf 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf \- conversia de ieșire formatată a caracterelor late .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP \fB#include \fP .PP \fBint wprintf(const wchar_t *restrict \fP\fIformat\fP\fB, ...);\fP \fBint fwprintf(FILE *restrict \fP\fIstream\fP\fB,\fP \fB const wchar_t *restrict \fP\fIformat\fP\fB, ...);\fP \fBint swprintf(wchar_t \fP\fIwcs\fP\fB[restrict .\fP\fImaxlen\fP\fB], size_t \fP\fImaxlen\fP\fB,\fP \fB const wchar_t *restrict \fP\fIformat\fP\fB, ...);\fP .PP \fBint vwprintf(const wchar_t *restrict \fP\fIformat\fP\fB, va_list \fP\fIargs\fP\fB);\fP \fBint vfwprintf(FILE *restrict \fP\fIstream\fP\fB,\fP \fB const wchar_t *restrict \fP\fIformat\fP\fB, va_list \fP\fIargs\fP\fB);\fP \fBint vswprintf(wchar_t \fP\fIwcs\fP\fB[restrict .\fP\fImaxlen\fP\fB], size_t \fP\fImaxlen\fP\fB,\fP \fB const wchar_t *restrict \fP\fIformat\fP\fB, va_list \fP\fIargs\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 .\" .BR wprintf (), .\" .BR fwprintf (), .\" .BR swprintf (), .\" .BR vwprintf (), .\" .BR vfwprintf (), .\" .BR vswprintf (): Toate funcțiile prezentate mai sus: .nf _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L .fi .SH DESCRIERE Familia de funcții \fBwprintf\fP() este echivalentul în caractere late al familiei de funcții \fBprintf\fP(3). Aceasta realizează o ieșire formatată a caracterelor late. .PP Funcțiile \fBwprintf\fP() și \fBvwprintf\fP() efectuează ieșirea de caractere late către \fIstdout\fP (ieșirea standard). \fIstdout\fP nu trebuie să fie orientată pe octeți; a se vedea \fBfwide\fP(3) pentru mai multe informații. .PP Funcțiile \fBfwprintf\fP() și \fBvfwprintf\fP() efectuează ieșirea de caractere late către \fIstream\fP. \fIstream\fP nu trebuie să fie orientat pe octeți; a se vedea \fBfwide\fP(3) pentru mai multe informații. .PP Funcțiile \fBswprintf\fP() ș i \fBvswprintf\fP() efectuează ieșirea de caractere late către o matrice de caractere late. Programatorul trebuie să se asigure că există spațiu pentru cel puțin \fImaxlen\fP caractere late la \fIwcs\fP. .PP Aceste funcții sunt similare funcțiilor \fBprintf\fP(3), \fBvprintf\fP(3), \fBfprintf\fP(3), \fBvfprintf\fP(3), \fBsprintf\fP(3), \fBsprintf\fP(3), \fBvsprintf\fP(3), cu excepția următoarelor diferențe: .TP \fB\[bu]\fP Șirul \fIformat\fP este un șir de caractere late. .TP \fB\[bu]\fP Ieșirea constă în caractere late, nu în octeți. .TP \fB\[bu]\fP \fBswprintf\fP() și \fBvswprintf\fP() acceptă un argument \fImaxlen\fP, \fBsprintf\fP(3) și \fBvsprintf\fP(3) nu; (\fBsnprintf\fP(3) și \fBvsnprintf\fP(3) acceptă un argument \fImaxlen\fP, dar aceste funcții nu returnează \-1 la depășirea memoriei tampon în Linux). .PP Tratamentul caracterelor de conversie \fBc\fP și \fBs\fP este diferit: .TP \fBc\fP Dacă nu este prezent nici un modificator \fBl\fP, argumentul \fIint\fP este convertit într\-un caracter lat printr\-un apel la funcția \fBbtowc\fP(3), iar caracterul lat rezultat este scris. Dacă este prezent un modificator \fBl\fP, se scrie argumentul \fIwint_t\fP (caracter lat). .TP \fBs\fP Dacă nu este prezent nici un modificator \fBl\fP: se așteaptă ca argumentul \fIconst\ char\ *\fP să fie un indicator la o matrice de tip caracter (indicator la un șir de caractere) care conține o secvență de caractere de mai mulți octeți care începe în starea inițială de deplasare. Caracterele din matrice sunt convertite în caractere late (fiecare prin apelarea funcției \fBmbrtowc\fP(3) cu o stare de conversie care începe în starea inițială înainte de primul octet). Caracterele late rezultate se scriu până la (dar fără a include) caracterul lat nul de sfârșit (L„\e0”). În cazul în care se specifică o precizie, nu se scriu mai multe caractere late decât numărul specificat. Rețineți că precizia determină numărul de \fIcaractere late\fP scrise, nu numărul de \fIocteți\fP sau \fIpoziții pe ecran\fP. Matricea trebuie să conțină un octet de sfârșit nul („\e0”), cu excepția cazului în care se indică o precizie și aceasta este atât de mică încât numărul de caractere late convertite îl atinge înainte de a se ajunge la sfârșitul matricei. În cazul în care este prezent un modificator \fBl\fP: se așteaptă ca argumentul \fIconst\ wchar_t\ *\fP să fie un indicator la o matrice de caractere late. Caracterele late din matrice se scriu până la (dar fără a include) un caracter lat nul de sfârșit. În cazul în care se specifică o precizie, nu se scriu mai multe caractere decât numărul specificat. Matricea trebuie să conțină un caracter lat nul de sfârșit, cu excepția cazului în care se indică o precizie și aceasta este mai mică sau egală cu numărul de caractere late din matrice. .SH "VALOAREA RETURNATĂ" Funcțiile returnează numărul de caractere late scrise, cu excepția caracterului lat de sfârșit nul în cazul funcțiilor \fBswprintf\fP() și \fBvswprintf\fP(). Ele returnează \-1 atunci când apare o eroare. .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 \fBwprintf\fP(), \fBfwprintf\fP(), \fBswprintf\fP(), \fBvwprintf\fP(), \fBvfwprintf\fP(), \fBvswprintf\fP() T} Siguranța firelor MT\-Safe locale .TE .sp 1 .SH STANDARDE C11, POSIX.1\-2008. .SH ISTORIC POSIX.1\-2001, C99. .SH NOTE Comportamentul lui \fBwprintf\fP() și altele depinde de categoria \fBLC_CTYPE\fP din configurația regională curentă. .PP În cazul în care șirul \fIformat\fP conține caractere late non\-ASCII, programul va funcționa corect numai dacă categoria \fBLC_CTYPE\fP a configurației regionale curente în momentul execuției este aceeași cu categoria \fBLC_CTYPE\fP a configurației regionale curente în momentul compilării. Acest lucru se datorează faptului că reprezentarea \fIwchar_t\fP este dependentă de platformă și de configurația regională; (glibc reprezintă caracterele late folosind punctul de cod Unicode (ISO/IEC 10646) al acestora, dar alte platforme nu fac acest lucru; de asemenea, utilizarea numelor de caractere universale C99 de forma \eunnnn nu rezolvă această problemă). Prin urmare, în programele internaționalizate, șirul \fIformat\fP ar trebui să fie format numai din caractere ASCII late sau ar trebui să fie construit în timpul execuției într\-un mod internaționalizat (de exemplu, folosind \fBgettext\fP(3) sau \fBiconv\fP(3), urmat de \fBmbstowcs\fP(3)). .SH "CONSULTAȚI ȘI" \fBfprintf\fP(3), \fBfputwc\fP(3), \fBfwide\fP(3), \fBprintf\fP(3), \fBsnprintf\fP(3) .\" .BR wscanf (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 .