NOMBRE

       strtod, strtof, strtold - convierten una cadena ASCII a un número en coma flotante

SINOPSIS

       #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);

   Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

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

DESCRIPCIÓN

       Las  funciones strtod(), strtof() y strtold() convierten la porción inicial de la cadena a
       la que apunta nptr a representación double, float, y long double, respectivamente.

       El formato esperado para (la porción inicial de) la cadena es un espacio inicial opcional,
       comprobado  por isspace(3), un signo opcional de más (“+”) o menos (“-”) seguido de (i) un
       número decimal, o (ii) un  número  hexadecimal,  o  (iii)  un  infinito,  o  (iv)  un  NAN
       (not-a-number).

       Un  número  decimal  consiste  en  una secuencia no vacía de dígitos decimales conteniendo
       posiblemente  un  carácter  radical  (punto  decimal,  dependiente  de  la   localización,
       normalmente  “.”),  seguida  opcionalmente por un exponente decimal.  Un exponente decimal
       consiste en un carácter “E” o “e”, seguido por un signo opcional de más o  menos,  seguido
       por  una secuencia no vacía de dígitos decimales, e indica multiplicación por una potencia
       de 10.

       Un número hexadecimal consiste en una cadena “0x” o “0X”  seguida  por  una  secuencia  no
       vacía  de  dígitos  hexadecimales  conteniendo  posiblemente  un carácter radical, seguida
       opcionalmente por un exponente binario. Un exponente binario consiste en un carácter “P” o
       “p”,  seguido  de  un signo opcional de más o menos, seguido por una secuencia no vacía de
       dígitos decimales, e indica multiplicación por una potencia de 2.   Al  menos  debe  estar
       presente o el carácter radical o el exponente binario.

       Un infinito es o bien una cadena "INF" o "INFINITY", sin importar las mayúsuculas.

       A  NAN  is  "NAN"  (disregarding case) optionally followed by a string, (n-char-sequence),
       where n-char-sequence specifies in an implementation-dependent way the type  of  NAN  (see
       NOTES).

VALOR DEVUELTO

       Esta funciones devuelven el valor convertido, si lo hay.

       Si  endptr  no  es  NULL,  un  puntero al caracter tras el último caracter utilizado en la
       conversión es almacenado en la posición referenciada por endptr.

       If no conversion is performed, zero is returned and (unless endptr is null) the  value  of
       nptr is stored in the location referenced by endptr.

       If the correct value would cause overflow, plus or minus HUGE_VAL, HUGE_VALF, or HUGE_VALL
       is returned (according to the return type and sign of the value), and ERANGE is stored  in
       errno.

       If the correct value would cause underflow, a value with magnitude no larger than DBL_MIN,
       FLT_MIN, or LDBL_MIN is returned and ERANGE is stored in errno.

ERRORES

       ERANGE Hubo desbordamiento por arriba o por abajo.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌──────────────────────┬────────────────────┬─────────────────────────────────────────────┐
       │Interfaz              │ Atributo           │ Valor                                       │
       ├──────────────────────┼────────────────────┼─────────────────────────────────────────────┤
       │strtod(), strtof(),   │ Seguridad del hilo │ Configuración regional de multi-hilo seguro │
       │strtold()             │                    │                                             │
       └──────────────────────┴────────────────────┴─────────────────────────────────────────────┘

CONFORME A

       POSIX.1-2001, POSIX.1-2008, C99.

       strtod()  was also described in C89.

NOTAS

       Since  0  can  legitimately  be  returned on both success and failure, the calling program
       should set errno to 0 before the call, and then determine if an error occurred by checking
       whether errno has a nonzero value after the call.

       In  the  glibc  implementation,  the  n-char-sequence  that  optionally  follows  "NAN" is
       interpreted as an integer number (with an optional '0' or '0x' prefix to select base 8  or
       16)  that is to be placed in the mantissa component of the returned value.

EJEMPLOS

       See  the example on the strtol(3)  manual page; the use of the functions described in this
       manual page is similar.

VÉASE TAMBIÉN

       atof(3), atoi(3), atol(3), nan(3), nanf(3), nanl(3), strfromd(3), strtol(3), strtoul(3)

COLOFÓN

       Esta página es parte de la versión 5.13 del proyecto Linux man-pages. Puede encontrar  una
       descripción  del  proyecto, información sobre cómo informar errores y la última versión de
       esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

       La traducción al español de esta página del manual fue creada  por  Vicente  Pastor  Gómez
       <vpastorg@santandersupernet.com> y Miguel Pérez Ibars <mpi79470@alu.um.es>

       Esta  traducción  es  documentación  libre;  lea  la  GNU General Public License Version 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o posterior con respecto a las condiciones  de
       copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción de esta página del manual, envíe un correo
       electrónico a ⟨debian-l10n-spanish@lists.debian.org⟩.