_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l
Konvertiert eine 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
Zu konvertierende mit NULL endende Zeichenfolge.endptr
Zeiger auf ein Zeichen, mit dem die Überprüfung beendet wird.base
Zu verwendende Zahlenbasis.locale
Das zu verwendende Gebietsschema.
Rückgabewert
_strtoi64 gibt den Wert zurück, der in der Zeichenfolge nptr, außer dargestellt wird, als Darstellung ein Überlauf verursacht, in diesem Fall von _I64_MAX oder _I64_MIN zurückgibt. Die Funktion gibt 0 zurück, wenn keine Konvertierung ausgeführt werden kann. _wcstoi64 gibt Werte analog zu strtoi64 zurück.
_I64_MAX und _I64_MIN werden in LIMITS.H definiert.
Wenn nptrNULL ist, oder base nicht NULL und entweder weniger als 2 oder größer als 36 ist, wird errno auf EINVAL festgelegt.
Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Die _strtoi64- Funktion konvertiert nptr in __int64. Beide Funktionen beenden das Lesen der nptr-Zeichenfolge am ersten Zeichen, das nicht als Teil einer Zahl erkannt wird. Dies ist möglicherweise das abschließende Nullzeichen, kann aber auch das erste numerische Zeichen sein, dass größer oder gleich base ist. _wcstoi64 ist eine Breitzeichenversion von _strtoi64. Das dazugehörige nptr-Argument ist eine Breitzeichenfolge. Anderenfalls verhalten sich diese Funktionen identisch.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
---|---|---|---|
_tcstoi64 |
_strtoi64 |
_strtoi64 |
_wcstoi64 |
_tcstoi64_l |
_strtoi64_l |
_strtoi64_l |
_wcstoi64_l |
Die LC_NUMERIC-Kategorieeinstellung des Gebietsschemas bestimmt das Erkennen des Basiszeichens in nptr*.* Weitere Informationen finden Sie unter setlocale. Die Features ohne das _l Suffix verwenden das aktuelle Gebietsschema; _strtoi64_l und _wcstoi64_l sind der entsprechenden Funktion ohne das Suffix _l identisch, allerdings verwenden das Gebietsschema, das ein- stattdessen übergeben wird. Weitere Informationen finden Sie unter Locale.
Wenn endptr nicht NULL ist, wird ein Zeiger auf das Zeichen, das die Überprüfung beendet hat, an dem Ort gespeichert, auf den durch endptr gezeigt wird. Wenn keine Konvertierung ausgeführt werden kann (keine gültigen Ziffern gefunden oder ungültige Basis angegeben), wird der Wert von nptr an dem Speicherort gespeichert, auf den durch endptr gezeigt wird.
_strtoi64 erwartet nptr, auf eine Zeichenfolge der folgenden Form zu veranschaulichen:
[whitespace] [{+ | –}] [0 [{ x | X }]] [digits]
whitespace besteht möglicherweise aus Leerzeichen und Tabulatorzeichen, die ignoriert werden. digits sind eine oder mehrere Dezimalstellen. Das erste Zeichen, das dieser Form nicht entspricht, beendet die Überprüfung. Wenn base zwischen 2 und 36 liegt, wird dieser Wert als Basis der Zahl verwendet. Wenn base 0 ist, werden die ersten Zeichen der Zeichenfolge, auf die durch nptr gezeigt wird, zur Bestimmung der Basis verwendet. Wenn das erste Zeichen "0" und das zweite Zeichen nicht "x" oder "X" ist, wird die Zeichenfolge als ganze Oktalzahl interpretiert. Wenn das erste Zeichen "0" und das zweite Zeichen nicht "x" oder "X" ist, wird die Zeichenfolge als hexadezimale ganze Zahl interpretiert. Wenn das erste Zeichen "1" bis "9 " ist, wird die Zeichenfolge als ganze Dezimalzahl interpretiert. Die Buchstaben "a" bis "z" (bzw. "A" bis "Z") werden den Werten 10 bis 35 zugewiesen. Nur Buchstaben, deren zugewiesene Werte kleiner als base sind, sind zulässig. Das erste Zeichen außerhalb des Bereichs der Basis beendet die Überprüfung. Wenn beispielsweise base 0 und das erste überprüfte Zeichen "0" ist, wird eine ganze Oktalzahl angenommen und das Zeichen "8" oder "9" beendet die Überprüfung.
Anforderungen
Routine |
Erforderlicher Header |
---|---|
_strtoi64, _strtoi64_l |
<stdlib.h> |
_wcstoi64, _wcstoi64_l |
<stdlib.h> oder <wchar.h> |
Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Siehe auch
Referenz
Funktionen zur Konvertierung von Zeichenfolgen in numerische Werte
strtod, _strtod_l, wcstod, _wcstod_l