Stringa alle funzioni di valore numerico

• strtod, _strtod_l, wcstod, _wcstod_l

• strtol, wcstol, _strtol_l, _wcstol_l

• strtoul, _strtoul_l, wcstoul, _wcstoul_l

• _strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

• _strtoui64, _wcstoui64, _strtoui64_l, _wcstoui64_l

Note

Ogni funzione nella famiglia strtod converte una stringa con terminazione null a un valore numerico.Nella tabella riportata di seguito vengono elencate le funzioni disponibili.

wcstod, wcstol, wcstoule _wcstoi64 sono versioni a caratteri estesi di strtod, strtol, strtoule _strtoi64, rispettivamente.L'argomento di tipo stringa a ognuna di queste funzioni a caratteri estesi è una stringa di caratteri estesi, ogni funzione si comporta in modo identico alla sua relativa controparte in single byte character.

La funzione strtod accetta due argomenti: il primo è la stringa di input e la seconda un puntatore al carattere che termina il processo di conversione.strtol, strtoul, _strtoi64 e _strtoui64 accettano un terzo argomento come il numero base da utilizzare nel processo di conversione.

La stringa di input è una sequenza di caratteri che può essere interpretata come valore numerico del tipo specificato.Ogni funzione interrompe la lettura della stringa in corrispondenza del primo carattere non riconosciuto come parte di un numero.Questo può rappresentare il carattere di terminazione null.Per strtol, strtoul, _strtoi64e _strtoui64, questo carattere di terminazione può essere il primo carattere numerico maggiore o uguale del numero fornito dall'utente.

Se il puntatore, fornito dall'utente, a un carattere di fine di conversione non è impostato su NULL al momento della chiamata, verrà archiviato un puntatore al carattere che interrompe la scansione.Se nessuna conversione può essere eseguita (nessuna cifra valida è stata trovata o è stata specificata una base non valida), il valore del puntatore della stringa viene archiviato all'indirizzo.

strtod si aspetta una stringa nel formato seguente:

[spazio] [segno] [digits] [**.**digits] [ {d | D | e | E}[sign]digits]

Uno spazio può essere costituito dallo spazio o di caratteri di tabulazione, che vengono ignorati; il segno è sia più (+) che meno (–); e digits è una o più cifre decimali.Se nessuna cifra viene visualizzata prima del carattere radice, almeno uno deve apparire dopo il carattere di base.Le cifre decimali possono essere seguite da un esponente, costituito da una lettera introduttiva (d, D, e, o E) e opzionalmente da un signed integer.Se né una parte dell'esponente né un carattere di base viene visualizzato, un carattere di base viene utilizzato per seguire l'ultima cifra nella stringa.Il primo carattere non idoneo interrompe la scansione.

Il strtol, strtoul, _strtoi64e le funzioni _strtoui64 si aspettano una stringa del formato seguente:

spazio] [{+ | -}] [0 [{ x | X }]] [digits]

Se l'argomento di base è compreso tra 2 e 36, quindi viene utilizzato come base del numero.Se è 0, i caratteri iniziali a cui fanno riferimento dal puntatore di fine di conversione vengono utilizzati per determinare la base.Se il primo carattere è 0 e il secondo carattere non è 'x' o 'X', la stringa viene interpretata come intero ottale; in caso contrario, viene interpretata come numero decimale.Se il primo carattere è '0' e il secondo carattere è 'x' o 'X', la stringa viene interpretata come intero esadecimale.Se il primo carattere è '1' e '9', la stringa viene interpretata come intero decimale.Le lettere da 'a' a 'z' (o da 'A' a 'Z') sono assegnati i valori da 10 a 35; solo lettere con valori assegnati minori della base sono permesse.strtoul e _strtoui64 consentono un segno più (+) o meno (–) come prefisso; un segno meno iniziale indica che il valore restituito è negato.

Il valore di output è interessato dall'impostazione dell'impostazione di categoria LC_NUMERIC delle impostazioni locali; vedere setlocale per ulteriori informazioni.Le versioni di queste funzioni senza il suffisso _l utilizzano le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali; le versioni con il suffisso _l sono identiche, ad eccezione del fatto che utilizzano il parametro delle impostazioni locali che viene passato.

Quando il valore restituito da queste funzioni può causare un overflow o un underflow, o quando la conversione non è possibile, i valori speciali vengono restituiti come mostrato di seguito:

_I64_MAX, _I64_MIN, e _UI64_MAX sono definiti in LIMITS.H.

wcstod, wcstol, wcstoul, _wcstoi64e _wcstoui64 sono versioni a caratteri estesi strtod, strtol, strtoul, _strtoi64e _strtoui64, rispettivamente; il puntatore a un argomento di fine conversione a ognuna di queste funzioni a caratteri estesi è una stringa di caratteri estesi.In caso contrario, ognuna di queste funzioni a caratteri estesi si comporta in modo identico alla relativa controparte in single byte character.

Vedere anche

Riferimenti

Conversione di dati

Impostazioni locali

Interpretazione delle sequenze di caratteri multibyte

Supporto per le operazioni in virgola mobile

atof, _atof_l, _wtof, _wtof_l