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 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.

Linux                                           1 Noviembre 2020                                       STRTOD(3)