atoll, _atoll_l, _wtoll, _wtoll_l

Konvertiert eine Zeichenfolge in eine long long-Ganzzahl.

Syntax

long long atoll(
   const char *str
);
long long _wtoll(
   const wchar_t *str
);
long long _atoll_l(
   const char *str,
   _locale_t locale
);
long long _wtoll_l(
   const wchar_t *str,
   _locale_t locale
);

Parameter

str
Zu konvertierende Zeichenfolge.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

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

Bei einem Überlauf mit großen positiven ganzzahligen Werten gibt atollLLONG_MAX zurück, und bei einem Überlauf mit großen negativen ganzzahligen Werten gibt LLONG_MIN zurück.

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 long long-Ganzzahl.

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 NULL-Zeichen ('\0' or L'\0') sein, das die Zeichenfolge beendet.

Das str-Argument für atoll 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 eine oder mehrere Ziffern.

_wtoll ist mit atoll identisch, außer dass es eine Zeichenfolge mit Breitzeichen als Parameter verwendet.

Die Versionen dieser Funktionen mit dem _l-Suffix sind identisch mit den Versionen, die keinen Suffix haben, verwenden jedoch den Gebietsschemaparameter, der anstelle des aktuellen Gebietsschemas übergeben wurde. 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
_tstoll	atoll	atoll	_wtoll
_tstoll_l	_atoll_l	_atoll_l	_wtoll_l
_ttoll	_atoll	_atoll	_wtoll

Anforderungen

Routinen	Erforderlicher Header
atoll, _atoll_l	<stdlib.h>
_wtoll, _wtoll_l	<stdlib.h> oder <wchar.h>

Beispiel

Dieses Programm zeigt, wie die atoll-Funktionen verwendet werden, um als Zeichenfolgen gespeicherte Zahlen in numerische Werte zu konvertieren.

// crt_atoll.c
// Build with: cl /W4 /Tc crt_atoll.c
// This program shows how to use the atoll
// functions to convert numbers stored as
// strings to numeric values.
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

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

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

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

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

Function: atoll("  -27182818284 ") = -27182818284
Function: atoll("314127.64") = 314127
Function: atoll("3336402735171707160320") = 9223372036854775807
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