atol, _atol_l, _wtol, _wtol_l

Articolo
06/09/2015

Convertire una stringa in un long integer.

long atol(
   const char *str 
);
long _atol_l(
   const char *str,
   _locale_t locale
);
long _wtol(
   const wchar_t *str 
);
long _wtol_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 long che viene prodotto interpretando i caratteri di input come un numero. Il valore restituito è 0L per atol se l'input non può essere convertito in un valore di tale tipo.

Nel caso di overflow con i valori integrali positivi, atol restituisce LONG_MAX; nel caso di overflow con i valori integrali negativi, viene restituito LONG_MIN. 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 long integer (atol).

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' o L'\0') che termina la stringa.

L'argomento str per atol 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.

_wtol è identico ad atol, con la differenza che accetta come parametro una stringa di caratteri "wide".

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
_tstol	atol	atol	_wtol
_ttol	atol	atol	_wtol

Requisiti

Routine	Intestazione obbligatoria
atol	<stdlib.h>
_atol_l, _wtol, _wtol_l	<stdlib.h> e <wchar.h>

Esempio

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

// crt_atol.c
// This program shows how numbers stored as
// strings can be converted to numeric values
// using the atol functions.
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

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

    // An example of the atol function
    // with leading and trailing white spaces.
    str = "  -2309 ";
    value = atol( str );
    printf( "Function: atol( \"%s\" ) = %d\n", str, value );

    // Another example of the atol function 
    // with an arbitrary decimal point.
    str = "314127.64";
    value = atol( str );
    printf( "Function: atol( \"%s\" ) = %d\n", str, value );

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