NOMBRE

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

SINOPSIS

       #include <stdlib.h>

       double strtod(const char *nptr, char **endptr);
       float strtof(const char *nptr, char **endptr);
       long double strtold(const char *nptr, char **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(), strtold() │ Seguridad del hilo │ Configuración regional de multi-hilo seguro │
       └──────────────────────────────┴────────────────────┴─────────────────────────────────────────────┘

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.10 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 ⟨⟩.