atoi, _atoi_l, _wtoi, _wtoi_l

Articolo
06/09/2015

Converte una stringa in un intero.

int atoi(
   const char *str 
);
int _wtoi(
   const wchar_t *str 
);
int _atoi_l(
   const char *str,
   _locale_t locale
);
int _wtoi_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 int che viene prodotto interpretando i caratteri di input come un numero. Il valore restituito è 0 per atoi e _wtoi, se l'input non può essere convertito in un valore di questo tipo.

Nel caso di overflow con i valori interi negativi, viene restituito LONG_MIN. atoi e _wtoi restituiscono INT_MAX e INT_MIN su queste condizioni. In tutti i casi esterni all'intervallo, errno è 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 integer (atoi e _wtoi). 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 a atoi e _wtoi ha la seguente forma:

[whitespace] [sign] [digits]]

Un whitespace è costituito dallo spazio o dai caratteri di tabulazione, che vengono ignorati; sign può essere più (+) o meno (–); e digits sono costituite da una o più cifre.

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. Per ulteriori informazioni, vedere Impostazioni locali.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tstoi	atoi	atoi	_wtoi
_ttoi	atoi	atoi	_wtoi

Requisiti

Routine	Intestazione obbligatoria
atoi	<stdlib.h>
_atoi_l, _wtoi, _wtoi_l	<stdlib.h> o <wchar.h>

Esempio

Questo programma mostra come i numeri memorizzati come stringhe possono essere convertiti in valori numerici usando le funzioni atoi.

// crt_atoi.c
// This program shows how numbers 
// stored as strings can be converted to
// numeric values using the atoi functions.

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

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

    // An example of the atoi function.
    str = "  -2309 ";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function.
    str = "31412764";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function 
    // with an overflow condition occuring.
    str = "3336402735171707160320";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );
    if (errno == ERANGE)
    {
       printf("Overflow condition occurred.\n");
    }
}