_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Artykuł
06/09/2015

Konwertuj ciąg na wartość __int64.

__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
);

Parametry

nptr
Ciąg zakończony zerem do przekonwertowania.
endptr
Wskaźnik znaku zatrzymującego skanowanie.
base
Numer podstawowy do użycia.
locale
Ustawienia regionalne do użycia.

Wartość zwracana

Funkcja _strtoi64zwraca wartość, która jest reprezentowana w ciągu nptr, z wyjątkiem przypadków, gdy ta reprezentacja spowodowałoby przepełnienie; wówczas funkcja zwraca wartość _I64_MAX lub _I64_MIN.Funkcja zwróci wartość 0, jeśli nie można wykonać konwersji._wcstoi64 zwraca wartości analogicznie do strtoi64.

_I64_MAX i _I64_MIN są zdefiniowane w LIMITS.H.

Jeśli parametr nptr jest NULL lub parametr base jest różny od zera i albo mniejszy niż 2 albo większy niż 36, atrybut errno jest ustawiany na EINVAL.

Aby uzyskać więcej informacji na temat tych i innych kodów powrotnych, zobacz _doserrno, errno, _sys_errlist, and _sys_nerr.

Uwagi

Funkcja _strtoi64konwertuje parametr nptr na wartość __int64.Obie funkcje przestają odczytywać ciąg nptr przy pierwszym znaku, którego nie są w stanie rozpoznać jako elementu liczby.Może to być kończący znak null lub pierwszy znak numeryczny, który jest większy lub równy base._wcstoi64 to wersja znaku dwubajtowego _strtoi64; jej argument nptr jest ciągiem znaku dwubajtowego.W innych przypadkach funkcje te zachowują się identycznie.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE & _MBCS nie zdefiniowano	_MBCS zdefiniowano	_UNICODE zdefiniowany
_tcstoi64	_strtoi64	_strtoi64	_wcstoi64
_tcstoi64_l	_strtoi64_l	_strtoi64_l	_wcstoi64_l

Ustawienie kategorii LC_NUMERIC ustawień regionalnych określa rozpoznawanie znaku podstawy w parametrze nptr*;* aby uzyskać więcej informacji, zobacz setlocale.Funkcje, które nie mają przyrostka _l używają bieżących ustawień regionalnych; _strtoi64_l i _wcstoi64_l są identyczne z odpowiednią funkcją, która nie ma przyrostka _l, z tą różnicą, że w zamian korzystają z przekazanych ustawień regionalnych.Aby uzyskać więcej informacji, zobacz Regionalne.

Jeśli endptr nie jest NULL, wskaźnik znaku, który zatrzymał skanowanie jest przechowywany w lokalizacji wskazywanej przez endptr.Jeśli konwersja nie może być wykonywana (nie znaleziono żadnych prawidłowych cyfr lub określono nieprawidłową podstawę), wartość nptr jest przechowywana w lokalizacji wskazywanej przez endptr.

Funkcja_strtoi64oczekuje, że parametr nptr wskaże ciąg o następującej postaci:

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

whitespace może składać się ze znaków spacji lub tabulatora, które są ignorowane; digits to jedna lub więcej cyfr dziesiętnych.Pierwszy znak, który nie mieści się w tym formularzu zatrzymuje skanowanie.Jeśli base jest między 2 a 36, zostanie użyty jako podstawa numeru.Jeśli atrybut base ma wartość 0, początkowe znaki ciągu wskazywane przez atrybut nptr są używane do określenia podstawy.Jeśli pierwszym znakiem jest 0, a drugim znakiem nie jest ,,x" lub ,,X", ciąg jest interpretowany jako ósemkowa liczba całkowita.Jeśli pierwszym znakiem jest ,,0", a drugim znakiem jest ,,x" lub ,,X", ciąg jest interpretowany jako szesnastkowa liczba całkowita.Jeśli pierwszym znakiem jest ,,1" do ,,9", ciąg jest interpretowany jako dziesiętna liczba całkowita.Literom ,,a" do ,,z" (lub ,,A" do ,,Z") są przypisane wartości od 10 do 35; tylko litery, których przypisane wartości są mniejsze niż base są dozwolone.Pierwszy znak spoza zakresu podstawy zatrzymuje skanowanie.Na przykład, jeśli atrybut base wynosi 0 i pierwszy znak skanowany to „0”, zakłada się liczbę całkowitą w postaci ósemkowej oraz, że znak „8” lub „9” zatrzyma skanowanie.