atof, _atof_l, _wtof, _wtof_l

Artigo
08/25/2010

Converter uma seqüência de caracteres em dupla.

double atof(
   const char *str 
);
double _wtof(
   const wchar_t *str 
);

Parâmetros

str
Seqüência de caracteres a ser convertido.
locale
Localidade usar.

Valor de retorno

Cada função retorna o double valor produzido por interpretar sistema autônomo caracteres de entrada sistema autônomo um número. O valor retornado é 0,0 se a entrada não pode ser convertida para um valor de tipo.

In Visual C++ 2005, em todos os casos de fora do intervalo, errno é conjunto para ERANGE. Se o parâmetro passado é NULL, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções conjunto errno para EINVAL e retornar 0.

Comentários

Essas funções convertem uma seqüência de caractere de um valor de ponto flutuante de precisão dupla.

A cadeia de caracteres de entrada é uma sequência de caracteres que podem ser interpretados sistema autônomo um valor numérico do tipo especificado.A função interrompe a leitura a cadeia de caracteres de entrada no primeiro caractere que não reconhece sistema autônomo parte de um número.Esse caractere pode ser o caractere nulo ('\0' ou '\0' L) encerrar a cadeia de caracteres.

The str argumento para atofe _wtof tem a seguinte forma:

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

A whitespace consiste em caracteres de espaço ou tabulação, que são ignorados sign é um sinal de adição (+) ou menos (-); e digits são um ou mais dígitos Decimal. Se nenhum dígito aparecer antes da vírgula decimal, pelo menos um deve aparecer após a vírgula decimal.Dígitos decimais podem ser seguidos por um expoente, que consiste em uma carta introdutória (d, D, e, ou E) e um inteiro decimal assinado opcionalmente.

As versões dessas funções com o _l sufixo são idênticas exceto que usarem o parâmetro de localidade passado em vez da localidade corrente.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tstof	atof	atof	_wtof
_ttof	atof	atof	_wtof

Requisitos

Routine(s)	Cabeçalho necessário
atof	<math.h> e <stdlib.h>
_atof_l	<math.h> e <stdlib.h>
_wtof, _wtof_l	<stdlib.h> ou <wchar.h>

Exemplo

Este programa mostra sistema autônomo sistema autônomo números armazenados sistema autônomo seqüências de caracteres podem ser convertidas em valores numéricos usando o atof função.

// crt_atof.c
//
// This program shows how numbers stored as 
// strings can be converted to numeric
// values using the atof function.

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

int main( void )
{
    char    *str = NULL;
    double  value = 0;

    // An example of the atof function
    // using leading and training spaces.
    str = "  3336402735171707160320 ";
    value = atof( str );
    printf( "Function: atof( \"%s\" ) = %e\n", str, value );

    // Another example of the atof function
    // using the 'd' exponential formatting keyword.
    str = "3.1412764583d210";
    value = atof( str );
    printf( "Function: atof( \"%s\" ) = %e\n", str, value );

    // An example of the atof function
    // using the 'e' exponential formatting keyword.
    str = "  -2309.12E-15";
    value = atof( str );
    printf( "Function: atof( \"%s\" ) = %e\n", str, value );

}

Function: atof( "  3336402735171707160320 " ) = 3.336403e+021 Function: atof( "3.1412764583d210" ) = 3.141276e+210 Function: atof( "  -2309.12E-15" ) = -2.309120e-012