atol, _atol_l, _wtol, _wtol_l

Konvertiert eine Zeichenfolge in eine lange ganze Zahl.

Syntax

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

Parameter

str
Zu konvertierende Zeichenfolge.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

Jede Funktion gibt den long-Wert zurück, der erstellt wird, indem die Eingabezeichen als Zahl interpretiert werden. Der Rückgabewert gilt 0L , atol wenn die Eingabe nicht in einen Wert dieses Typs konvertiert werden kann.

Wenn diese Funktionen mit großen positiven integralen Werten überlaufen, werden sie zurückgegeben LONG_MAX. Wenn die Funktionen mit großen negativen integralen Werten überlaufen, LONG_MIN wird diese zurückgegeben. In Fällen, in denen alle Werte außerhalb des Gültigkeitsbereichs liegen, wird errno auf ERANGE festgelegt. Wenn der übergebene NULLParameter ist, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, stellen diese Funktionen errno auf EINVAL ein und geben 0 zurück.

Hinweise

Diese Funktionen konvertieren eine Zeichenfolge in eine lange ganze Zahl (atol).

Die Eingabezeichenfolge ist eine Sequenz von Zeichen, die als numerischer Wert des angegebenen Typs interpretiert werden. Die Funktion beendet das Lesen der Eingabezeichenfolge am ersten Zeichen, das nicht als Teil einer Zahl erkannt werden kann. Dieses Zeichen kann das Nullzeichen (\0 oder L\0) sein, das die Zeichenfolge beendet.

Das str-Argument für atol weist folgende Form auf:

[whitespace] [sign] [digits]

A whitespace besteht aus Leerzeichen oder Tabstoppzeichen, die ignoriert werden; sign ist entweder Pluszeichen (+) oder Minuszeichen (-); und digits es handelt sich um eine oder mehrere Ziffern.

_wtol ist mit atol identisch, außer dass es eine Zeichenfolge mit Breitzeichen verwendet.

Die Versionen dieser Funktionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch den ihnen übergebenen Gebietsschemaparameter anstelle des aktuellen Gebietsschemas. Weitere Informationen finden Sie unter Locale.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

TCHAR.H Routine _UNICODE und _MBCS nicht definiert _MBCS Definiert _UNICODE Definiert
_tstol atol atol _wtol
_ttol atol atol _wtol

Anforderungen

Routinen Erforderlicher Header
atol <stdlib.h>
_atol_l, _wtol, _wtol_l <stdlib.h> und <wchar.h>

Beispiel

Dieses Programm zeigt, wie die atol-Funktion verwendet wird, um als Zeichenfolgen gespeicherte Zahlen in numerische Werte zu konvertieren.

// 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");
    }
}
Function: atol( "  -2309 " ) = -2309
Function: atol( "314127.64" ) = 314127
Function: atol( "3336402735171707160320" ) = 2147483647
Overflow condition occurred.

Siehe auch

Datenkonvertierung
Mathematische und Gleitkommaunterstützung
Gebietsschema
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l