strtod(3)                  Library Functions Manual                  strtod(3)

NUME
       strtod, strtof, strtold - convertesc un <?>ir ASCII in numar in virgula
       mobila

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdlib.h>

       double strtod(const char *restrict nptr, char **restrict endptr);
       float strtof(const char *restrict nptr, char **restrict endptr);
       long double strtold(const char *restrict nptr, char **restrict endptr);

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

       strtof(), strtold():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

DESCRIERE
       Func<?>iile strtod(), strtof() <?>i strtold() convertesc por<?>iunea
       ini<?>iala a <?>irului indicat de nptr in reprezentarea double, float
       <?>i, respectiv, long double.

       Forma a<?>teptata a <?>irului (por<?>iunii ini<?>iale a <?>irului) este
       un spa<?>iu alb de inceput op<?>ional, astfel cum este recunoscut de
       isspace(3), un semn plus (,,+") sau minus (,,-") op<?>ional <?>i apoi
       fie (i) un numar zecimal, fie (ii) un numar hexazecimal, fie (iii) un
       infinit, fie (iv) un NAN (not-a-number).

       Un numar zecimal consta dintr-o secven<?>a nevida de cifre zecimale
       care poate con<?>ine un caracter drept separator zecimal (semn zecimal,
       in func<?>ie de configura<?>ia regionala, de obicei ,,."), urmat,
       op<?>ional, de un exponent zecimal. Un exponent zecimal consta dintr-un
       ,,E" sau ,,e", urmat de un semn plus sau minus op<?>ional, urmat de o
       secven<?>a nevida de cifre zecimale, <?>i indica inmul<?>irea cu o
       putere de 10.

       Un numar hexazecimal este format dintr-un ,,0x" sau ,,0X" urmat de o
       secven<?>a nevida de cifre hexazecimale care poate con<?>ine un
       caracter drept separator, urmat, op<?>ional, de un exponent binar. Un
       exponent binar consta dintr-un ,,P" sau ,,p", urmat de un semn plus sau
       minus op<?>ional, urmat de o secven<?>a nevida de cifre zecimale <?>i
       indica inmul<?>irea cu o putere de 2. Trebuie sa fie prezent (cel
       pu<?>in unul dintre ele) fie caracterul cu rol separator, fie
       exponentul binar.

       Un infinit este fie ,,INF", fie ,,INFINITY", fara a lua in considerare
       diferen<?>ele dintre ele.

       Un NAN este ,,NAN" (fara a lua in considerare majusculele <?>i
       minusculele) urmat, op<?>ional, de un <?>ir de caractere,
       (n-char-sequence), unde n-char-sequence specifica tipul de NAN intr-un
       mod care depinde de implementare (a se vedea sec<?>iunea NOTE).

VALOAREA RETURNATA
       Aceste func<?>ii returneaza valoarea convertita, daca exista.

       Daca endptr nu este NULL, in loca<?>ia la care face referire endptr se
       stocheaza un indicator la caracterul de dupa ultimul caracter utilizat
       in conversie.

       Daca nu se efectueaza nicio conversie, se returneaza zero <?>i (cu
       excep<?>ia cazului in care endptr este nul) valoarea lui nptr este
       stocata in loca<?>ia la care face referire endptr.

       In cazul in care valoarea corecta ar provoca o depa<?>ire, se
       returneaza plus sau minus HUGE_VAL, HUGE_VALF sau HUGE_VALL (in
       func<?>ie de tipul de returnare <?>i de semnul valorii), iar ERANGE
       este stocat in errno.

       In cazul in care valoarea corecta ar provoca o depa<?>ire a limitei
       minime (ar fi sub valoarea minima), se returneaza o valoare cu
       magnitudinea nu mai mare decat DBL_MIN, FLT_MIN sau LDBL_MIN, iar
       ERANGE este stocat in errno.

ERORI-IE<?>IRE
       ERANGE A aparut o depa<?>ire a limitei superioare/inferioare.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +-------------------------------+---------------------+----------------+
       |Interfa<?>a                    | Atribut             | Valoare        |
       +-------------------------------+---------------------+----------------+
       |strtod(), strtof(), strtold()  | Siguran<?>a firelor | MT-Safe locale |
       +-------------------------------+---------------------+----------------+
VERSIUNI
       In implementarea glibc, secven<?>a n-char-sequence care urmeaza
       op<?>ional dupa ,,NAN" este interpretata ca un numar intreg (cu un
       prefix op<?>ional ,,0" sau ,,0x" pentru a selecta baza 8 sau 16) care
       urmeaza sa fie plasat in componenta mantisa a valorii returnate.

STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       strtod()
              C89, POSIX.1-2001.

       strtof()
       strtold()
              C99, POSIX.1-2001.

NOTE
       Deoarece 0 poate fi returnat in mod legitim atat in caz de succes, cat
       <?>i in caz de e<?>ec, programul apelant ar trebui sa stabileasca errno
       la 0 inainte de apel, iar apoi sa determine daca s-a produs o eroare
       verificand daca errno are o valoare diferita de zero dupa apel.

EXEMPLE
       A se vedea exemplul de pe pagina de manual strtol(3); utilizarea
       func<?>iilor descrise in aceasta pagina de manual este similara.

CONSULTA<?>I <?>I
       atof(3), atoi(3), atol(3), nan(3), nanf(3), nanl(3), strfromd(3),
       strtol(3), strtoul(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                     strtod(3)