std:: strtoimax, std:: strtoumax

Интерпретирует целочисленное значение в байтовой строке, на которую указывает nptr .

Отбрасывает любые пробельные символы (определяемые вызовом std::isspace ) до первого непробельного символа, затем принимает максимально возможное количество символов, формирующих корректное base-n (где n= base ) целочисленное представление и преобразует их в целочисленное значение. Корректное целочисленное значение состоит из следующих частей:

• (необязательно) знак плюс или минус
• (необязательно) префикс ( 0 ), обозначающий восьмеричную систему счисления (применяется только когда основание равно 8 или ​ 0 ​ )
• (необязательно) префикс ( 0x или 0X ), обозначающий шестнадцатеричную систему счисления (применяется только когда основание равно 16 или ​ 0 ​ )
• последовательность цифр

Множество допустимых значений для основания системы счисления составляет {0, 2, 3, ..., 36} . Множество допустимых цифр для целых чисел с основанием 2 составляет {0, 1} , для целых чисел с основанием 3 — {0, 1, 2} и так далее. Для оснований больше 10 допустимые цифры включают буквенные символы, начиная с Aa для целых чисел с основанием 11 и до Zz для целых чисел с основанием 36 . Регистр символов игнорируется.

Дополнительные числовые форматы могут приниматься текущей установленной C локалью .

Если значение base равно ​ 0 ​ , система счисления определяется автоматически: если префикс 0 , используется восьмеричная система, если префикс 0x или 0X , используется шестнадцатеричная система, в противном случае используется десятичная система.

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

Функция устанавливает указатель, на который указывает endptr , чтобы он указывал на символ после последнего интерпретированного символа. Если endptr является нулевым указателем, он игнорируется.

Если nptr пуст или не имеет ожидаемой формы, преобразование не выполняется, и (если enptr не является нулевым указателем) значение nptr сохраняется в объекте, на который указывает endptr .

Параметры

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

• В случае успеха возвращается целочисленное значение, соответствующее содержимому str .
• Если преобразованное значение выходит за пределы диапазона соответствующего возвращаемого типа, возникает ошибка диапазона (устанавливается errno в ERANGE ) и возвращается INTMAX_MAX , INTMAX_MIN , UINTMAX_MAX или ​ 0 ​ , в зависимости от ситуации.
• Если преобразование не может быть выполнено, ​ 0 ​ возвращается.

Пример

#include <cinttypes>
#include <iostream>
#include <string>
int main()
{
    std::string str = "helloworld";
    std::intmax_t val = std::strtoimax(str.c_str(), nullptr, 36);
    std::cout << str << " in base 36 is " << val << " in base 10\n";
    char* nptr;
    val = std::strtoimax(str.c_str(), &nptr, 30);
    if (nptr != &str[0] + str.size())
        std::cout << str << " in base 30 is invalid."
                  << " The first invalid digit is '" << *nptr << "'\n";
}

helloworld in base 36 is 1767707668033969 in base 10
helloworld in base 30 is invalid. The first invalid digit is 'w'

Смотрите также