wcstol(), wcstoll()

Преобразовать строку широких символов в длинное целое число (long integer)

Прототип:

#include <wchar.h>
long wcstol( const wchar_t *ptr,
wchar_t **endptr,
int base );
long long wcstoll( const wchar_t *ptr,
wchar_t **endptr,
int base );

Аргументы:

ptr
Указатель на строку, состоящую из широких символов.
endptr
Если аргумент не равен NULL, функция сохраняет по адресу из значения аргумента указатель на первое вхождение нераспознанного символа, найденного в строке.
base
Основание числа:

Библиотека:

libc

Описание:

Функция wcstol() преобразует строку, указанную в аргументе ptr, в число с типом long; wcstoll() преобразует строку в число с типом long long.

Эти функции преобразуют строки, которые могут содержать:

Преобразование прекращается при первом нераспознанном широком символе. Если endptr не NULL, указатель на нераспознанный символ сохраняется в объекте, на который указывает endptr.

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

Преобразованное значение.

Если преобразованное значение вызывает переполнение, функция возвращает (INTMAX_MAX | UINTMAX_MAX or INTMAX_MIN) в соответствии знаку и устанавливает значение ERANGE переменной errno. Если основание за пределами диапазона, функция возвращает ноль, а переменной errno устанавливается значение EDOM.

Коды ошибок:

ERANGE
Значение непредставимо
EINVAL
Значение для base не поддерживается или преобразование не может быть выполнено.

Классификация:

ANSI, POSIX 1003.1

Точка остановки потока
Нет
Обработчик прерываний
Да
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

errno wcrtomb(), wcsrtombs(), wcstod(), wcstof(), wcstold(), wcstoimax(), wcstoumax(), wcstok(), wcstombs(), wcstoul(), wcstoull(), wctob(), wctomb()




Предыдущий раздел: Описание API системной библиотеки