_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Článek
03/04/2013

Převést řetězec na __int64 hodnotu.

__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
Řetězec zakončený převést.
endptr
Ukazatel na znak, který zastaví skenování.
base
Číslo základní použití.
locale
Národní prostředí použít.

Vrácená hodnota

_strtoi64Vrátí hodnotu zastoupeny v řetězci nptr, s výjimkou při zastupování způsobí přetečení, ve kterém případě ji vrátí _I64_MAX nebo _I64_MIN.Pokud žádný převod lze provést, vrátí funkce 0._wcstoi64Vrátí hodnoty postupuje analogicky k strtoi64.

_I64_MAXa _I64_MIN jsou definovány v MEZÍCH.H.

Pokud nptr je NULL nebo base je nenulová a buď méně než 2 nebo vyšší než 36, errno je nastavena na EINVAL.

Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto a jiných návratových kódů.

Poznámky

The _strtoi64function converts nptr to an __int64.Obě funkce Zastavit čtení řetězec nptr jejich nelze rozpoznat jako součást čísla prvního znaku.To může být ukončujícím znakem null, nebo může být první číselný znak větší než nebo rovno base._wcstoi64je verze celého znaku _strtoi64; jeho nptr je řetězec znaků wide argument.Tyto funkce chovat stejně jinak.

Obecný Text rutinní mapování

TCHAR.Rutina H	_UNICODE & _MBCS není definován	_MBCS, definice	_UNICODE, definice
_tcstoi64	_strtoi64	_strtoi64	_wcstoi64
_tcstoi64_l	_strtoi64_l	_strtoi64_l	_wcstoi64_l

Na národní prostředí LC_NUMERIC kategorie nastavení určuje rozpoznávání znaku radix nptr*;* Další informace naleznete v tématu setlocale.Funkce bez přípony _l použít aktuální národní prostředí; _strtoi64_la_wcstoi64_l jsou stejné jako odpovídající funkce bez _l příponu, s výjimkou, že používají místo předaný národní prostředí.Další informace naleznete v tématu Národní prostředí.

Pokud endptr není NULL, ukazatel na znak, který přestal skenování je uložen v umístění odkazuje endptr.Pokud lze provést bez převodu (nebyly nalezeny žádné platné číslice nebo byl zadán neplatný base) hodnotu nptr je uložen na adrese, na kterou odkazuje endptr.

_strtoi64očekává nptr pro řetězec následující formulář:

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

A whitespace se může skládat z místa a kartu znaky, které jsou ignorovány; digitsjsou-li jeden nebo více desetinných míst.První znak, který tento formulář nevejde zastaví skenování.Pokud base je mezi 2 a 36, použita jako základní číslo.Pokud base 0 počátečních znaků odkazuje řetězec nptr jsou použity ke stanovení základu.Pokud je první znak je 0 a druhý znak "x" nebo "X", řetězec interpretován jako osmičkové číslo; jinak je interpretován jako desetinné číslo.Pokud je první znak "0" a druhý znak "x" nebo "X" řetězec interpretována jako hexadecimální číslo.Pokud je první znak ' 1' až ' 9', řetězec je interpretován jako desítkové celé číslo.Písmena "a" až "z" (nebo "A" až "Z") jsou přiřazeny hodnoty 10 až 35; pouze písmena, jejichž přiřazené hodnoty jsou menší než base jsou povoleny.