wcstoimax(), wcstoumax()

Преобразовать строку широких символов в целое число

Прототип:

#include <inttypes.h>
                                       
intmax_t wcstoimax ( const wchar_t *nptr,
                     wchar_t **endptr,
                     int base );
                                       
uintmax_t wcstoumax ( const wchar_t *nptr,
                      wchar_t **endptr,
                      int base );

Аргументы:

nptr

Указатель на строку, состоящую из широких символов.

endptr

Если аргумент не равен NULL, функция сохраняет по адресу из значения аргумента указатель на первое вхождение нераспознанного символа, найденного в строке.

base

Основание числа:

Если base равен нулю, первые символы после знака (необязательного) определяют основание для преобразования. Если первый символ 0x или 0X, то цифры рассматриваются как шестнадцатеричные. Если первый символ равен 0, цифры рассматриваются как восьмеричные. Во всех остальных случаях используется десятичное основание числа.
Если base не равен нулю, аргумент должен быть в диапазоне от 2 до 36. Буквы a-z и A-Z используются для представления значений от 10 до 35. Только те буквы, значение которых меньше base, разрешены. Если основание числа равно 16, символы 0x или 0X могут опционально предшествовать последовательности букв и цифр.

Описание:

Функции wcstoimax() и wcstoumax() аналогичны функциям wcstol(), wcstoll(), wcstoul() и wcstoull() за исключением того, что они возвращают объекты типов intmax_t и uintmax_t.

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

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

ANSI, POSIX 1003.1

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

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

strtol(), wcrtomb(), wcsrtombs(), wcstod(), wcstof(), wcstold(), wcstok(), wcstol(), wcstoll(), wcstombs(), wcstoul(), wcstoull(), wctob(), wctomb()

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