_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Artykuł
02/27/2013

Przekonwertować ciąg na __int64 wartości.

__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, aby przekonwertować.
endptr
Wskaźnik myszy na znak, który zatrzymuje skanowanie.
base
Bazowy numer ma być użyty.
locale
Ustawienia regionalne, aby użyć.

Wartość zwracana

_strtoi64Zwraca wartość reprezentowane w ciągu nptr, z wyjątkiem gdy przedstawienie spowodowałoby przepełnienie, w którym sprawa go zwraca _I64_MAX lub _I64_MIN.Funkcja zwróci 0, jeśli można wykonać bez konwersji._wcstoi64Zwraca wartości analogiczne do strtoi64.

_I64_MAXi _I64_MIN są zdefiniowane w granicach.H.

Jeśli nptr jest NULL lub base jest różna od zera i albo mniej niż 2 lub większy niż 36, errno jest ustawiona na EINVAL.

Zobacz _doserrno, errno, _sys_errlist i _sys_nerr uzyskać więcej informacji o tych i innych, kody zwracane.

Uwagi

The _strtoi64function converts nptr to an __int64.Obie funkcje zatrzymać czytanie ciąg nptr na pierwszy znak nie można uznać za część liczby.Może to być kończącego znaku null lub może być pierwszego znaku numerycznego, większe niż lub równe base._wcstoi64jest to wersja szerokich znaków _strtoi64; jego nptr argument jest łańcuch szerokich znaków.Te funkcje działają identycznie inaczej.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rutynowe H	_UNICODE & Nie zdefiniowano _MBCS	_MBCS, definicja	_UNICODE, definicja
_tcstoi64	_strtoi64	_strtoi64	_wcstoi64
_tcstoi64_l	_strtoi64_l	_strtoi64_l	_wcstoi64_l

Ustawienia regionalne LC_NUMERIC kategorii ustawienie określa rozpoznawania znaków radix w nptr*;* uzyskać więcej informacji, zobacz setlocale.Funkcje bez sufiks _l Użyj bieżącego ustawienia regionalne; _strtoi64_li_wcstoi64_l są takie same, jak odpowiadające im funkcji bez _l sufiks, z wyjątkiem, że używają oni przekazany zamiast ustawień regionalnych.Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Jeśli endptr nie jest NULL, wskaźnik do znaku, którego praca została zatrzymana skanowania jest przechowywany w lokalizacji wskazywanej przez endptr.Jeśli można wykonać bez konwersji (nie znaleziono żadnych prawidłowych cyfr lub określono nieprawidłowy base), wartość nptr jest przechowywany w lokalizacji wskazywanej przez endptr.

_strtoi64oczekuje, że nptr wskaż ciąg następującą postać:

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

A whitespace może składać się ze znaków spacji i tabulatora, które są ignorowane; digitssą z jednego lub więcej cyfr dziesiętnych.Pierwszy znak, który nie mieści się ta forma zatrzymuje skanowanie.Jeśli base jest między 2 a 36, zostanie użyty jako podstawa liczby.Jeśli base jest równa 0, początkowe znaki ciągu wskazywanej przez nptr są używane do określenia podstawy.Jeśli pierwszy znak jest równa 0, a drugi znak nie jest 'x' lub 'X', ciąg jest interpretowana jako ósemkową liczby całkowitej; w przeciwnym razie jest interpretowana jako liczbę dziesiętną.Jeśli pierwszy znak jest "0" i jest drugi znak 'x' lub 'X', ciąg jest interpretowana jako szesnastkowe liczbą całkowitą.Jeśli pierwszy znak jest "1" przez "9", ciąg jest interpretowana jako dziesiętną liczbę całkowitą.Litery "" do "z" (lub "" przez "Z") są przypisane wartości od 10 do 35; tylko litery, w której przypisane wartości są mniejsze niż base są dozwolone.