strtoimax(), strtoumax()

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

Прототип:

#include <inttypes.h>
                                       
intmax_t strtoimax( const char *nptr,
                    char **endptr,
                    int base );
                                      
uintmax_t strtoumax( const char *nptr,
                     char **endptr,
                     int base );

Аргументы:

nptr

Указатель на строку для преобразования.

endptr

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

base

Основание системы счисления анализируемого числа:

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

Описание:

Функции strtoimax() и strtoumax() аналогичны функциям strtol(), strtoll(), strtoul() и strtoull(), за исключением того, что они возвращают объекты типа intmax_t и uintmax_t.

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

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

ANSI, POSIX 1003.1

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

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

strtol(), strtoul()

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