_atoi64, , _atoi64_l_wtoi64_wtoi64_l

Konvertiert eine Zeichenfolge in eine 64-Bit-Ganzzahl.

Syntax

__int64 _atoi64(
   const char *str
);
__int64 _wtoi64(
   const wchar_t *str
);
__int64 _atoi64_l(
   const char *str,
   _locale_t locale
);
__int64 _wtoi64_l(
   const wchar_t *str,
   _locale_t locale
);

Parameter

str
Zu konvertierende Zeichenfolge.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

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

Wenn die Funktionen mit großen positiven integralen Werten überlaufen, werden sie zurückgegeben I64_MAX. Die Funktionen geben zurück I64_MIN , wenn sie mit großen negativen integralen Werten überlaufen.

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 64-Bit-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. Möglicherweise ist dies das Zeichen NULL ('\0' oder L'\0'), das am Ende der Zeichenfolge steht.

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

[] [] [whitespace] [signdigits]

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

_wtoi64 ist mit _atoi64 identisch, außer dass es eine Zeichenfolge mit Breitzeichen als Parameter 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. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

Anforderungen

Beispiel

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

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

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

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

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

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

Function: _atoi64( "  -2309 " ) = -2309
Function: _atoi64( "314127.64" ) = 314127
Function: _atoi64( "3336402735171707160320" ) = -1
Overflow condition occurred.

Siehe auch

Datenkonvertierung
Mathematische Unterstützung und Gleitkommaunterstützung
Gebietsschema
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, , _atodbl_l_atoldbl, _atoldbl_l, , _atoflt_atoflt_l