atoi, _atoi_l, _wtoi_wtoi_l

Convertire una stringa in integer.

Sintassi

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 usare.

Valore restituito

Ogni funzione restituisce il valore int che viene prodotto interpretando i caratteri di input come numero. Il valore restituito è 0 per atoi e _wtoi, se l'input non può essere convertito in un valore di tale tipo.

Quando le funzioni esondano con valori integrali negativi di grandi dimensioni, LONG_MIN viene restituito . atoi e _wtoi restituiscono INT_MAX e INT_MIN in queste condizioni. In tutti i casi fuori intervallo, errno è impostato su ERANGE. Se il parametro passato è NULL, viene richiamato 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.

Osservazioni:

Queste funzioni convertono 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 interrompe la lettura della stringa di input al primo carattere che non è in grado di riconoscere come parte di un numero. Questo carattere può essere il carattere null ('\0' o L'\0') che termina la stringa.

L'argomento str per atoi e _wtoi ha il formato seguente:

[] [whitespacesign] [] [digits]

Un whitespace oggetto è costituito da spazi o caratteri di tabulazione, che vengono ignorati; sign è più (+) o meno (-) e digits sono una o più cifre.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione per il fatto che usano il parametro delle impostazioni locali passato al posto di quelle correnti. Per altre informazioni, vedere Locale.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

TCHAR.H Routine	_UNICODE e _MBCS non definito	_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> oppure <wchar.h>

Esempio

Questo programma mostra come i numeri memorizzati come stringhe possono essere convertiti in valori numerici utilizzando 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 occurring.
    str = "3336402735171707160320";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );
    if (errno == ERANGE)
    {
       printf("Overflow condition occurred.\n");
    }
}

Function: atoi( "  -2309 " ) = -2309
Function: atoi( "31412764" ) = 31412764
Function: atoi( "3336402735171707160320" ) = 2147483647
Overflow condition occurred.

Vedi anche

Conversione dei dati
Supporto matematico e a virgola mobile
impostazioni locali
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt_atoflt_l