_atoi64, _atoi64_l, _wtoi64, _wtoi64_l

Artikel
02/26/2013

Konvertiert eine Zeichenfolge in eine 64-Bit-Ganzzahl.

__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
Der zu konvertierende Zeichenfolge.
locale
Der zu verwendende Gebietsschema.

Rückgabewert

Jede Funktion gibt den Wert zurück, der __int64 mithilfe der Eingabezeichen als Zahl erzeugt wird, interpretiert.Der Rückgabewert ist 0 für _atoi64 , wenn die Eingabe nicht auf einen Wert dieses Typs konvertiert werden kann.

Im Fall des Überlaufs mit großen positiven ganzzahligen Werten, gibt _atoi64I64_MAX und I64_MIN im Falle eines Überlaufs mit großen negativen ganzzahligen Werten zurück.

In allen Fällen wird errno außerhalb des Gültigkeitsbereichs zu ERANGEfestgelegt.Wenn der Parameter übergebene NULLungültige Parameter ist, wird der Ereignishandler aufgerufen, wie in Parametervalidierungbeschrieben.Wenn die Ausführung fortgesetzt werden kann, darf dieses Features zu EINVAL und legen errno return 0.

Hinweise

Diese Funktion konvertieren eine Zeichenfolge in einen 64-Bit-Ganzzahlwert.

Die Eingabezeichenfolge ist eine Folge von Zeichen, die als numerische Wert des angegebenen Typs interpretiert werden können.Die Funktion wird beendet, die Eingabezeichenfolge am ersten Zeichen zu lesen, das sie nicht als Teil einer Zahl erkennen kann.Dieses Zeichen kann das NULL-Zeichen („\ 0 " oder l " \ 0 ") die Zeichenfolge Beenden.

Das str-Argument an _atoi64 verfügt über das folgende Format:

[whitespace] [sign] [digits]]

whitespace besteht aus Leerzeichen oder Tabulatorzeichen, die ignoriert werden. sign ist entweder Plus (+) oder Minuszeichen (–); und digits sind eine oder mehrere Ziffern.

_wtoi64 ist mit _atoi64 identisch, mit der Ausnahme, dass es eine Zeichenfolge mit Breitzeichen als Parameter.

Die Versionen dieser Funktionen mit dem _l Suffix sind identisch, mit der Ausnahme, dass sie verwenden den Gebietsschemaparameter, der anstelle des aktuellen Gebietsschemas übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Zuweisung generischer Textroutinen

Tchar.h-Routine	_UNICODE als auch _MBCS nicht definiert	_MBCS definieren	_UNICODE definiert
_tstoi64	_atoi64	_atoi64	_wtoi64
_ttoi64	_atoi64	_atoi64	_wtoi64

Anforderungen

Routinen	Erforderlicher Header
_atoi64, _atoi64_l	<stdlib.h>
_wtoi64, _wtoi64_l	<stdlib.h> oder <wchar.h>

Beispiel

Dieses Programm zeigt, wie die Zahlen als Zeichenfolgen gespeichert werden, auf numerischen Werten mithilfe der _atoi64-Funktionen konvertiert werden können.

// 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");
    }
}