strfromd(3)                Library Functions Manual                strfromd(3)

NUME
       strfromd, strfromf, strfroml - converte<?>te o valoare in virgula
       mobila intr-un <?>ir de caractere

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdlib.h>

       int strfromd(char str[restrict .n], size_t n,
                    const char *restrict format, double fp);
       int strfromf(char str[restrict .n], size_t n,
                    const char *restrict format, float fp);
       int strfroml(char str[restrict .n], size_t n,
                    const char *restrict format, long double fp);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       strfromd(), strfromf(), strfroml():
           __STDC_WANT_IEC_60559_BFP_EXT__

DESCRIERE
       Aceste func<?>ii convertesc o valoare in virgula mobila, fp, intr-un
       <?>ir de caractere, str, cu un <?>ir format configurabil.  Cel mult n
       caractere sunt stocate in str.

       Octetul de terminare nul ("\0") este scris daca <?>i numai daca n este
       suficient de mare, altfel <?>irul scris este trunchiat la n caractere.

       Func<?>iile strfromd(), strfromf() <?>i strfroml() sunt echivalente cu

           snprintf(str, n, format, fp);

       cu excep<?>ia <?>irului format.

   Formatul <?>irului de format
       <?>irul format trebuie sa inceapa cu caracterul ,,%". Acesta este urmat
       de o precizie op<?>ionala care incepe cu caracterul punct (.), urmat de
       un numar intreg zecimal op<?>ional. In cazul in care nu se specifica
       niciun numar intreg dupa caracterul punct, se utilizeaza o precizie de
       zero. In cele din urma, <?>irul de format trebuie sa aiba unul dintre
       specificatorii de conversie a, A, e, E, f, F, F, g sau G.

       Specificatorul de conversie se aplica in func<?>ie de tipul de virgula
       mobila indicat de sufixul func<?>iei. Prin urmare, spre deosebire de
       snprintf(), <?>irul de format nu are un caracter modificator de
       lungime. A se vedea snprintf(3) pentru o descriere detaliata a acestor
       specificatori de conversie.

       Implementarea este conforma cu standardul C99 privind conversia
       valorilor NaN <?>i infinit:

              Daca fp este un NaN, +NaN sau -NaN <?>i f (sau a, e, g) este
              specificatorul de conversie, conversia este in ,,nan" ; ,,nan",
              sau respectiv ,,-nan". Daca F (sau A, E, G) este specificatorul
              de conversie, conversia este la ,,NAN" sau ,,-NAN".

              In mod similar, daca fp este infinit, acesta este convertit in
              [-]inf sau [-]INF.

       Un <?>ir format incorect are ca rezultat un comportament nedefinit.

VALOAREA RETURNATA
       Func<?>iile strfromd(), strfromf() <?>i strfroml() returneaza numarul
       de caractere care ar fi fost scrise in str daca n ar fi avut suficient
       spa<?>iu, fara a lua in considerare octetul nul de terminare. Astfel, o
       valoare de returnare de n sau mai mare inseamna ca ie<?>irea a fost
       trunchiata.

ATRIBUTE
       Pentru o explica<?>ie a termenilor utiliza<?>i in aceasta sec<?>iune,
       consulta<?>i attributes(7) <?>i sec<?>iunea POSIX Safety Concepts din
       manualul GNU C Library.

       +-------------------------------+---------------------+----------------+
       |Interfa<?>a                    | Atribut             | Valoare        |
       +-------------------------------+---------------------+----------------+
       |strfromd(), strfromf(),        | Siguran<?>a firelor | MT-Safe locale |
       |strfroml()                     |                     |                |
       +                               +---------------------+----------------+
       |                               | Async-signal safety | AS-Unsafe heap |
       +                               +---------------------+----------------+
       |                               | Async-cancel safety | AC-Unsafe mem  |
       +-------------------------------+---------------------+----------------+
       Nota: aceste atribute au caracter preliminar.

STANDARDE
       ISO/IEC TS 18661-1.

VERSIUNI
       strfromd()
       strfromf()
       strfroml()
              glibc 2.25.

NOTE
       Aceste func<?>ii <?>in cont de categoria LC_NUMERIC a configura<?>iei
       regionale curente.

EXEMPLE
       Pentru a converti valoarea 12.1 ca tip in virgula mobila, intr-un <?>ir
       folosind nota<?>ia zecimala, rezultand ,,12.100000":

           #define __STDC_WANT_IEC_60559_BFP_EXT__
           #include <stdlib.h>
           int ssize = 10;
           char s[ssize];
           strfromf(s, ssize, "%f", 12.1);

       Pentru a converti valoarea 12,3456 ca tip in virgula mobila, intr-un
       <?>ir folosind nota<?>ia zecimala cu doua cifre de precizie, rezultand
       ,,12,35":

           #define __STDC_WANT_IEC_60559_BFP_EXT__
           #include <stdlib.h>
           int ssize = 10;
           char s[ssize];
           strfromf(s, ssize, "%.2f", 12.3456);

       Pentru a converti valoarea 12.345e19 ca tip de dubla precizie intr-un
       <?>ir folosind nota<?>ia <?>tiin<?>ifica cu zero cifre de precizie,
       rezultand ,,1E+20":

           #define __STDC_WANT_IEC_60559_BFP_EXT__
           #include <stdlib.h>
           int ssize = 10;
           char s[ssize];
           strfromd(s, ssize, "%.E", 12.345e19);

CONSULTA<?>I <?>I
       atof(3), snprintf(3), strtod(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                   strfromd(3)