.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2000 Andries Brouwer (aeb@cwi.nl) .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH strfmon 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME strfmon, strfmon_l \- convertește o valoare monetară într\-un șir de caractere .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .PP \fBssize_t strfmon(char \fP\fIs\fP\fB[restrict .\fP\fImax\fP\fB], size_t \fP\fImax\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, ...);\fP \fBssize_t strfmon_l(char \fP\fIs\fP\fB[restrict .\fP\fImax\fP\fB], size_t \fP\fImax\fP\fB, locale_t \fP\fIlocale\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, ...);\fP .fi .SH DESCRIERE Funcția \fBstrfmon\fP() formatează suma monetară specificată în conformitate cu configurația regională curentă și cu specificația de format \fIformat\fP și plasează rezultatul în matricea de caractere \fIs\fP de dimensiune \fImax\fP. .PP Funcția \fBstrfmon_l\fP() îndeplinește aceeași sarcină, dar utilizează configurația regională specificată de \fIlocale\fP. Comportamentul funcției \fBstrfmon_l\fP() este nedefinit în cazul în care \fIlocale\fP este obiectul parametru special de configurație regională \fBLC_GLOBAL_LOCALE\fP (a se vedea \fBduplocale\fP(3)) sau nu este un gestionar de obiect de configurație regională valid. .PP Caracterele obișnuite din \fIformat\fP sunt copiate în \fIs\fP fără conversie. Specificatorii de conversie sunt introduși de un caracter „%”. Imediat după acesta pot exista zero sau mai multe dintre următoarele fanioane: .TP \fB=\fP\fIf\fP Caracterul de un singur octet \fIf\fP este utilizat drept caracter de umplere numerică (pentru a fi utilizat cu o precizie la stânga, a se vedea mai jos). Atunci când nu este specificat, se utilizează caracterul spațiu. .TP \fB\[ha]\fP Nu utilizează niciun caracter de grupare care ar putea fi definit pentru configurația regională curentă. În mod implicit, gruparea este activată. .TP \fB(\fP sau \fB+\fP Simbolul „(” indică faptul că sumele negative trebuie să fie incluse între paranteze. Simbolul „+” indică faptul că semnele trebuie tratate în mod implicit, adică sumele sunt precedate de indicația de semn din regiunea respectivă, de exemplu, nimic pentru valori pozitive, „\-” pentru valori negative. .TP \fB!\fP Omite simbolul monetar. .TP \fB\-\fP Aliniază la stânga toate câmpurile. Valoarea implicită este alinierea la dreapta. .PP În continuare, poate exista o lățime a câmpului: un șir de cifre zecimale care specifică o lățime minimă a câmpului în octeți. Valoarea implicită este 0. Un rezultat mai mic decât această lățime este completat cu spații (în stânga, cu excepția cazului în care a fost indicat fanionul aliniere\-stânga). .PP În continuare, poate exista o precizie stânga de forma „#” urmată de un șir de cifre zecimale.În cazul în care numărul de cifre din stânga caracterului zecimal „,” este mai mic decât acesta, reprezentarea este umplută în stânga cu caracterul de umplere numeric. Caracterele de grupare nu sunt luate în considerare în această lățime de câmp. .PP În continuare, poate exista o precizie la dreapta de forma „.” urmată de un șir de cifre zecimale. Suma care se formatează este rotunjită la numărul specificat de cifre înainte de formatare. Valoarea implicită este specificată în elementele \fIfrac_digits\fP și \fIint_frac_digits\fP din configurația regională curentă. Dacă precizia dreaptă este 0, nu se imprimă niciun caracter zecimal „. sau ,”; (caracterul zecimal aici este determinat de \fBLC_MONETARY\fP și poate fi diferit de cel specificat de \fBLC_NUMERIC\fP). .PP În cele din urmă, specificația de conversie trebuie să se încheie cu un caracter de conversie. Cele trei caractere de conversie sunt .TP \fB%\fP În acest caz, întreaga specificație trebuie să fie exact „%%”. Introduce un caracter „%” în șirul rezultat. .TP \fBi\fP Un argument de tip \fIdouble\fP este convertit folosind formatul internațional al monedei locale. .TP \fBn\fP Un argument de tip \fIdouble\fP este convertit folosind formatul național al monedei locale. .SH "VALOAREA RETURNATĂ" Funcția \fBstrfmon\fP() returnează numărul de caractere plasate în matricea \fIs\fP, fără a include octetul nul de terminare, cu condiția ca șirul, inclusiv octetul nul de terminare, să încapă. În caz contrar, configurează \fIerrno\fP la \fBE2BIG\fP, returnează \-1, iar conținutul matricei este nedefinit. .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 \fBstrfmon\fP() T} Siguranța firelor MT\-Safe locale T{ .na .nh \fBstrfmon_l\fP() T} Siguranța firelor MT\-Safe .TE .sp 1 .SH STANDARDE POSIX.1\-2008. .SH ISTORIC POSIX.1\-2001. .SH EXEMPLE Apelarea .PP .in +4n .EX strfmon(buf, sizeof(buf), "[%\[ha]=*#6n] [%=*#6i]", 1234.567, 1234.567); .EE .in .PP produce .PP .in +4n .EX [€ **1234,57] [EUR **1 234,57] .EE .in .PP în configurația regională \fInl_NL\fP. Configurațiile regionale \fIde_DE\fP, \fIde_CH\fP, \fIen_AU\fP și \fIen_GB\fP produc următoarele rezultate .PP .in +4n .EX [ **1234,57 €] [ **1.234,57 EUR] [ Fr. **1234.57] [ CHF **1\[aq]234.57] [ $**1234.57] [ AUD**1,234.57] [ £**1234.57] [ GBP**1,234.57] .EE .in .SH "CONSULTAȚI ȘI" \fBduplocale\fP(3), \fBsetlocale\fP(3), \fBsprintf\fP(3), \fBlocale\fP(7) .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 .