NOMBRE

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

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

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.

       The expected form of the (initial portion of the) string is optional leading  white  space
       as  recognized  by  isspace(3), an optional plus ('+') or minus sign ('-') and then either
       (i) a decimal number, or (ii) a hexadecimal number, or (iii) an infinity, or  (iv)  a  NAN
       (not-a-number).

       A  decimal  number consists of a nonempty sequence of decimal digits possibly containing a
       radix character (decimal point, locale-dependent, usually '.'), optionally followed  by  a
       decimal  exponent.   A decimal exponent consists of an 'E' or 'e', followed by an optional
       plus or minus sign, followed by a nonempty  sequence  of  decimal  digits,  and  indicates
       multiplication by a power of 10.

       A  hexadecimal  number  consists  of  a  "0x"  or  "0X" followed by a nonempty sequence of
       hexadecimal digits possibly containing a radix character, optionally followed by a  binary
       exponent.   A  binary  exponent  consists of a 'P' or 'p', followed by an optional plus or
       minus  sign,  followed  by  a  nonempty  sequence  of  decimal   digits,   and   indicates
       multiplication  by a power of 2.  At least one of radix character and binary exponent must
       be present.

       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.

       Si  no  se  realizó  conversión,  se  devuelve cero y el valor de nptr es almacenado en la
       posición referenciada por endptr, salvo que endptr sea nulo.

       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()             │                    │                                             │
       └──────────────────────┴────────────────────┴─────────────────────────────────────────────┘

ESTÁNDARES

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

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)

TRADUCCIÓN

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

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