atof, _atof_l, _wtof, _wtof_l

Articolo
06/09/2015

Convertire una stringa in double.

double atof(
   const char *str 
);
double _atof_l(
   const char *str,
   _locale_t locale
);
double _wtof(
   const wchar_t *str 
);
double _wtof_l(
   const wchar_t *str,
   _locale_t locale
);

Parametri

str
Stringa da convertire.
locale
Impostazioni locali da utilizzare.

Valore restituito

Ogni funzione restituisce il valore double che viene prodotto interpretando i caratteri di input come un numero. Il valore restituito è 0.0 se l'input non può essere convertito in un valore di tale tipo.

In tutti i casi esterni all'intervallo, errno viene impostato su ERANGE. Se il parametro passato è NULL, viene invocato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni impostano errno su EINVAL e restituiscono 0.

Note

Queste funzioni consentono di convertire una stringa di caratteri in un valore a precisione doppia e virgola mobile.

La stringa di input è una sequenza di caratteri che può essere interpretata come valore numerico del tipo specificato. La funzione arresta la lettura della stringa di input al primo carattere che non riconosce come parte di un numero. Questo carattere può essere il carattere null ('\0' or L'\0') che termina la stringa.

L'argomento str per atof e _wtof ha la seguente forma:

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

Un whitespace è costituito dallo spazio o dai caratteri di tabulazione, i quali vengono ignorati; sign può essere più (+) o meno (–); e digits sono una o più cifre decimali. Se nessuna cifra viene visualizzata prima del separatore decimale, almeno uno deve apparire dopo il separatore decimale. Le cifre decimali possono essere seguite da un esponente, costituito da una lettera introduttiva (d, D, e, o E) e opzionalmente da un numero decimale intero con segno.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione che utilizzano il parametro delle impostazioni locali passato in ingresso invece di utilizzare le impostazioni locali correnti.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tstof	atof	atof	_wtof
_ttof	atof	atof	_wtof

Requisiti

Routine(s)	Intestazione obbligatoria
atof	<stdlib.h> e <stdlib.h>
_atof_l	<stdlib.h> e <stdlib.h>
_wtof, _wtof_l	<stdlib.h> o <wchar.h>

Esempio

Questo programma mostra come i numeri memorizzati come stringhe possono essere convertiti in valori numerici usando la funzione atof.

// 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 );

}