_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Artikel
02/26/2013

Konvertieren einer Zeichenfolge in einen __int64-Wert.

__int64 _strtoi64(
   const char *nptr,
   char **endptr,
   int base 
);
__int64 _wcstoi64(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
__int64 _strtoi64_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
__int64 _wcstoi64_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

Parameter

nptr
Klicken Sie auf NULL endende Zeichenfolge zu konvertieren.
endptr
Zeiger auf Zeichen, das die Überprüfung beendet.
base
Der zu verwendende Basis.
locale
Das zu verwendende Gebietsschema.

Rückgabewert

_strtoi64gibt den Wert zurück, der in der Zeichenfolge dargestellt werden, es sei denn, nptrdie Darstellung als einem Überlauf führen würde. In diesem Fall wird sie _I64_MAX oder _I64_MINzurückgibt.Die Funktion gibt 0 zurück, wenn keine Konvertierung ausgeführt werden kann._wcstoi64 gibt Werte analog zu strtoi64zurück.

_I64_MAX und _I64_MIN werden in LIMITS.H. definiert.

Wenn nptrNULL ist, oder base und entweder kleiner als 2 oder größer als 36 nicht 0 ist, wird errno zu EINVALfestgelegt.

Weitere Informationen finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr Weitere Informationen über diese und andere Rückgabecodes.

Hinweise

Die _strtoi64Funktion konvertiert nptr zu __int64.Beenden beider Funktionen, der die Zeichenfolge nptr am ersten Zeichen gelesen, nicht als Teil einer Zahl erkennen können.Dies ist möglicherweise NULL, oder es ist möglicherweise die erste größer oder gleich basenumerische Zeichen._wcstoi64 ist eine Breitzeichen-Version von _strtoi64. handeln nptr-Argument ist eine Zeichenfolge mit Breitzeichen.Diese Funktionen verhalten sich ansonsten unterscheiden.

Zuweisung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definieren	_UNICODE definiert
_tcstoi64	_strtoi64	_strtoi64	_wcstoi64
_tcstoi64_l	_strtoi64_l	_strtoi64_l	_wcstoi64_l

Die LC_NUMERIC Kategorieeinstellung des Gebietsschemas bestimmt Erkennung des Basis Signierung in nptr*.* Weitere Informationen finden Sie unter setlocale.Die Funktionen ohne das Suffix verwenden _l dem aktuellen Gebietsschema. _strtoi64_l und_wcstoi64_l stehen der entsprechenden Funktion ohne das Suffix _l identisch, mit der Ausnahme, dass sie verwenden Sie stattdessen das Gebietsschema, das übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Wenn endptr nicht NULList, wird ein Zeiger auf das Zeichen, das die Überprüfung beendet wurde, am Speicherort gespeichert, der durch endptrdargestellt wird.Wenn keine Konvertierung ausgeführt werden kann (keine gültigen Ziffern gefunden wurden, oder eine ungültige Basis) angegeben wurde, wird der Wert von nptr am Speicherort gespeichert, der durch endptrdargestellt wird.

_strtoi64erwartet nptr , zu einer Zeichenfolge im folgenden Format zu veranschaulichen:

[whitespace] [{+ | –}] [0 [{ x | X }]] [digits]

whitespace besteht möglicherweise Leerzeichen, Tabstoppzeichen und die ignoriert werden. digits sind eine oder mehrere Dezimalstellen.Das erste Zeichen, das nicht das Formular passt, beendet die Überprüfung.Wenn base zwischen 2 und 36 liegt, wird er als Basis der Zahl verwendet.Wenn base 0 (null) ist, werden die ersten Zeichen der Zeichenfolge, die von nptr gezeigte verwendet, um die Basis zu bestimmen.Wenn das erste Zeichen 0 ist und das zweite Zeichen „x“ oder „X“ ist, wird die Zeichenfolge als oktale ganze Zahl interpretiert. Andernfalls wird sie als decimal interpretiert.Wenn das erste Zeichen „0 " festgelegt ist, und das zweite Zeichen „x“ oder „X“ ist, wird die Zeichenfolge als ganze Hexadezimalzahl interpretiert.Wenn das erste Zeichen „1 " bis „9 " ist, wird die Zeichenfolge als ganze Dezimalzahl interpretiert.Der Buchstabe“ bis „z“ (oder „A“ durch „Z ") werden die Werte 10 und 35 zugewiesen. nur alphabetische Zeichen, deren bestimmte Werte kleiner sind als base sind zulässig.