_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Статья
06/09/2015

Преобразование строки в значение типа __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
);

Параметры

nptr
Строка, заканчивающаяся нулевым символом, для преобразования.
endptr
Указатель на символ, который останавливает сканирование.
base
Основание системы счисления, который следует использовать.
locale
Используемый языковой стандарт.

Возвращаемое значение

_strtoi64возвращает значение, которое представлено в строке nptr, кроме случаев, когда представление вызвало бы переполнение; в этом случае возвращается значение _I64_MAX или _I64_MIN. Функция вернет 0, если преобразование не может быть выполнено. _wcstoi64 возвращает значения аналогично strtoi64.

_I64_MAX и _I64_MIN определены в LIMITS.H.

Если nptr имеет значение NULL или base отлично от нуля или либо меньше 2 или больше 36, то параметр errno получает значение EINVAL.

Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.

Заметки

Функция _strtoi64преобразует nptr в __int64. Обе функции прекращают чтение строки nptr на первом знаке, который они не могут распознать как часть числа. Это может быть конечный символ null или первый числовой символ, который больше или равен base. _wcstoi64 — это двухбайтовая версия _strtoi64; её аргумент nptr — строка двухбайтовых символов. В остальном эти функции ведут себя идентично.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_tcstoi64	_strtoi64	_strtoi64	_wcstoi64
_tcstoi64_l	_strtoi64_l	_strtoi64_l	_wcstoi64_l

Параметр категории LC_NUMERIC языкового стандарта определяет распознавание символа системы счисления в nptr*;* дополнительные сведения см. в разделе setlocale. Функции, не имеющие суффикса _l, используют текущий языковой стандарт; _strtoi64_l и_wcstoi64_l идентичны соответствующей функции, которая не имеет суффикса _l, за исключением того, что они используют переданный им языковой стандарт. Для получения дополнительной информации см. Языковой стандарт.

Если endptr не равен NULL, то указатель на символ, из-за которого было прекращено сканирование, хранится в ячейке памяти, на которую указывает endptr. Если преобразование не может быть выполнено (допустимые цифры не были найдены, или было указано недопустимое основание), то значение nptr хранится в ячейке памяти, на которую указывает endptr.

_strtoi64ожидает, что nptr указывает на строку следующей формы:

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

whitespace может состоять из пробелов и символов табуляции, которые игнорируются. digits — одна или несколько десятичных цифр. Первый символ, который не удовлетворяет этой форме, прекращает сканирование. Если base от 2 до 36, то он используется как основание системы счисления. Если значение base равно 0, то начальные символы строки, указанной в nptr используются для идентификации базы. Если первый символ — "0", а второй символ не равен "x" или "X", строка интерпретируется как восьмеричное целое число. Если первый символ — «0», а второй символ не равен «x» или «x», строка интерпретируется как шестнадцатеричное целое число. Если первый символ от «1» до «9», строка интерпретируется как десятичное целое число. Буквы от «а» до «z» присваиваются значения от 10 до 35; разрешены только буквы с присвоенными значениями меньше base. Первый символ вне диапазона базы останавливает сканирование. Например, если base — 0 и первый сканированный символ — "0", то предполагается восьмеричное целое число и символ "8" или "9" остановит сканирование.