.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2016, IBM Corporation. .\" Written by Wainer dos Santos Moschetta .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References consulted: .\" glibc 2.25 source code and manual. .\" C99 standard document. .\" ISO/IEC TS 18661-1 technical specification. .\" snprintf and other man.3 pages. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH strfromd 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME strfromd, strfromf, strfroml \- convertește o valoare în virgulă mobilă într\-un șir de caractere .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .PP \fBint strfromd(char \fP\fIstr\fP\fB[restrict .\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, double \fP\fIfp\fP\fB);\fP \fBint strfromf(char \fP\fIstr\fP\fB[restrict .\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, float \fP\fIfp\fP\fB);\fP \fBint strfroml(char \fP\fIstr\fP\fB[restrict .\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, long double \fP\fIfp\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 \fBstrfromd\fP(), \fBstrfromf\fP(), \fBstrfroml\fP(): .nf __STDC_WANT_IEC_60559_BFP_EXT__ .fi .SH DESCRIERE Aceste funcții convertesc o valoare în virgulă mobilă, \fIfp\fP, într\-un șir de caractere, \fIstr\fP, cu un șir \fIformat\fP configurabil. Cel mult \fIn\fP caractere sunt stocate în \fIstr\fP. .PP Octetul de terminare nul ("\e0") este scris dacă și numai dacă \fIn\fP este suficient de mare, altfel șirul scris este trunchiat la \fIn\fP caractere. .PP Funcțiile \fBstrfromd\fP(), \fBstrfromf\fP() și \fBstrfroml\fP() sunt echivalente cu .PP .in +4n .EX snprintf(str, n, format, fp); .EE .in .PP cu excepția șirului \fIformat\fP. .SS "Formatul șirului de format" Șirul \fIformat\fP trebuie să înceapă cu caracterul „%”. Acesta este urmat de o precizie opțională care începe cu caracterul punct (.), urmat de un număr întreg zecimal opțional. În cazul în care nu se specifică niciun număr întreg după caracterul punct, se utilizează o precizie de zero. În cele din urmă, șirul de format trebuie să aibă unul dintre specificatorii de conversie \fBa\fP, \fBA\fP, \fBe\fP, \fBE\fP, \fBf\fP, \fBF\fP, \fBF\fP, \fBg\fP sau \fBG\fP. .PP Specificatorul de conversie se aplică în funcție de tipul de virgulă mobilă indicat de sufixul funcției. Prin urmare, spre deosebire de \fBsnprintf\fP(), șirul de format nu are un caracter modificator de lungime. A se vedea \fBsnprintf\fP(3) pentru o descriere detaliată a acestor specificatori de conversie. .PP Implementarea este conformă cu standardul C99 privind conversia valorilor NaN și infinit: .PP .RS Dacă \fIfp\fP este un NaN, +NaN sau \-NaN și \fBf\fP (sau \fBa\fP, \fBe\fP, \fBg\fP) este specificatorul de conversie, conversia este în „nan” ; „nan”, sau respectiv „\-nan”. Dacă \fBF\fP (sau \fBA\fP, \fBE\fP, \fBG\fP) este specificatorul de conversie, conversia este la „NAN” sau „\-NAN”. .PP În mod similar, dacă \fIfp\fP este infinit, acesta este convertit în [\-]inf sau [\-]INF. .RE .PP Un șir \fIformat\fP incorect are ca rezultat un comportament nedefinit. .SH "VALOAREA RETURNATĂ" Funcțiile \fBstrfromd\fP(), \fBstrfromf\fP() și \fBstrfroml\fP() returnează numărul de caractere care ar fi fost scrise în \fIstr\fP dacă \fIn\fP ar fi avut suficient spațiu, fără a lua în considerare octetul nul de terminare. Astfel, o valoare de returnare de \fIn\fP sau mai mare înseamnă că ieșirea a fost trunchiată. .SH ATRIBUTE Pentru o explicație a termenilor utilizați în această secțiune, consultați \fBattributes\fP(7) și secțiunea \fBPOSIX Safety Concepts\fP din manualul GNU C Library. .PP .TS allbox; lbx lb lb l l l. Interfață Atribut Valoare T{ .na .nh \fBstrfromd\fP(), \fBstrfromf\fP(), \fBstrfroml\fP() T} Siguranța firelor MT\-Safe locale \^ Async\-signal safety AS\-Unsafe heap \^ Async\-cancel safety AC\-Unsafe mem .TE .sp 1 Notă: aceste atribute au caracter preliminar. .SH STANDARDE ISO/IEC TS 18661\-1. .SH VERSIUNI .TP \fBstrfromd\fP() .TQ \fBstrfromf\fP() .TQ \fBstrfroml\fP() glibc 2.25. .SH NOTE Aceste funcții țin cont de categoria \fBLC_NUMERIC\fP a configurației regionale curente. .SH EXEMPLE Pentru a converti valoarea 12.1 ca tip în virgulă mobilă, într\-un șir folosind notația zecimală, rezultând „12.100000”: .PP .in +4n .EX #define __STDC_WANT_IEC_60559_BFP_EXT__ #include int ssize = 10; char s[ssize]; strfromf(s, ssize, "%f", 12.1); .EE .in .PP Pentru a converti valoarea 12,3456 ca tip în virgulă mobilă, într\-un șir folosind notația zecimală cu două cifre de precizie, rezultând „12,35”: .PP .in +4n .EX #define __STDC_WANT_IEC_60559_BFP_EXT__ #include int ssize = 10; char s[ssize]; strfromf(s, ssize, "%.2f", 12.3456); .EE .in .PP Pentru a converti valoarea 12.345e19 ca tip de dublă precizie într\-un șir folosind notația științifică cu zero cifre de precizie, rezultând „1E+20”: .PP .in +4n .EX #define __STDC_WANT_IEC_60559_BFP_EXT__ #include int ssize = 10; char s[ssize]; strfromd(s, ssize, "%.E", 12.345e19); .EE .in .SH "CONSULTAȚI ȘI" \fBatof\fP(3), \fBsnprintf\fP(3), \fBstrtod\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 .