Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

strtod, _strtod_l, wcstod, _wcstod_l

Convertir las cadenas a un valor de precisión doble.

double strtod(
   const char *nptr,
   char **endptr 
);
double _strtod_l(
   const char *nptr,
   char **endptr,
   _locale_t locale
);
double wcstod(
   const wchar_t *nptr,
   wchar_t **endptr 
);
double wcstod_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   _locale_t locale
);

nptr

Cadena terminada en NULL que se va a convertir.

endptr

Puntero al carácter que detiene el examen.

locale

Configuración regional que se va a usar.

strtod devuelve el valor del número de punto flotante, excepto cuando la representación provocaría un desbordamiento, en cuyo caso la función devuelve +/-HUGE_VAL. El signo de HUGE_VAL coincide con el signo del valor que no se puede representar. strtod devuelve 0 si no se puede realizar ninguna conversión o si se produce un subdesbordamiento.

wcstod devuelve valores de manera parecida a strtod. Para ambas funciones, errno se establece en ERANGE si el desbordamiento o subdesbordamiento aparece y se invoca el controlador de parámetro no válido, tal como se describe en Validación de parámetros.

Vea _doserrno, errno, _sys_errlist, y _sys_nerr para obtener más información sobre estos y otros códigos de retorno.

Cada función convierte la cadena de entrada nptr en double. La función de strtod convierte nptr a un valor de precisión doble. strtod deja de leer la cadena nptr en el primer carácter que no reconoce como parte de un número. Este puede ser el carácter null final. wcstod es una versión con caracteres anchos de strtod; su argumento nptr es una cadena de caracteres anchos. Por lo demás, estas funciones se comportan exactamente igual.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcstod

strtod

strtod

wcstod

_tcstod_l

_strtod_l

_strtod_l

_wcstod_l

El valor de categoría de LC_NUMERIC de la configuración regional actual determina el reconocimiento de carácter de la base denptr; para obtener más información, vea setlocale. Las funciones sin el sufijo de _l utilizan la configuración regional actual; _strtod_l es idéntico a _strtod_l salvo que utilizan la configuración regional pasado en su lugar. Para obtener más información, vea Configuración regional.

Si endptr no es NULL, se almacena un puntero al carácter que detuvo el análisis en la ubicación a la que señala endptr. Si no se puede realizar ninguna conversión (no se encontraron dígitos válidos o se especificó una base no válida), el valor de nptr se almacena en la ubicación a la que señala endptr.

strtod espera que nptr señale a una cadena con el formato siguiente:

[whitespace] [sign] [digits] [.digits] [ {d | D | e | E }[sign]digits]

whitespace puede constar de espacio y caracteres de tabulación, que se omiten, sign puede ser más (+) o menos () y digits son uno o varios dígitos decimales. Si no aparece ningún dígito antes del carácter de base, debe aparecer al menos uno después del carácter de base. Los dígitos decimales pueden ir seguidos por un exponente, que consta de una letra preliminar (d, D, e o E) y, opcionalmente, un entero con signo. Si no aparece una parte del exponente ni un carácter de base, se supondrá que el carácter de base sigue el último dígito de la cadena. El primer carácter que no se ajusta a este formato detiene el análisis.

Rutina

Encabezado necesario

strtod , _strtod_l

<stdlib.h>

wcstod , _wcstod_l

<stdlib.h> o <wchar.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

// crt_strtod.c
// This program uses strtod to convert a
// string to a double-precision value; strtol to
// convert a string to long integer values; and strtoul
// to convert a string to unsigned long-integer values.
//

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   char   *string, *stopstring;
   double x;
   long   l;
   int    base;
   unsigned long ul;

   string = "3.1415926This stopped it";
   x = strtod( string, &stopstring );
   printf( "string = %s\n", string );
   printf("   strtod = %f\n", x );
   printf("   Stopped scan at: %s\n\n", stopstring );

   string = "-10110134932This stopped it";
   l = strtol( string, &stopstring, 10 );
   printf( "string = %s\n", string );
   printf("   strtol = %ld\n", l );
   printf("   Stopped scan at: %s\n\n", stopstring );

   string = "10110134932";
   printf( "string = %s\n", string );
 
   // Convert string using base 2, 4, and 8:
   for( base = 2; base <= 8; base *= 2 )
   {
      // Convert the string:
      ul = strtoul( string, &stopstring, base );
      printf( "   strtol = %ld (base %d)\n", ul, base );
      printf( "   Stopped scan at: %s\n", stopstring );
   }
}
la cadena = 3.1415926This la detuvieron
   strtod = 3,141593
   Análisis detenido en: esto lo detuvo

la cadena = -10110134932This se detuvieron
   strtol = -2147483648
   Análisis detenido en: esto lo detuvo

cadena = 10110134932
   strtol = 45 (base 2)
   Análisis detenido en: 34932
   strtol = 4423 (base 4)
   Análisis detenido en: 4932
   strtol = 2134108 (base 8)
   Análisis detenido en: 932

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft