std:: wcstoimax, std:: wcstoumax

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

Отбрасывает любые пробельные символы (определяемые вызовом std::iswspace ) до первого непробельного символа, затем принимает максимально возможное количество символов, формирующих корректное представление беззнакового целого числа в 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 является нулевым указателем, он игнорируется.

Параметры

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

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

Пример

#include <cinttypes>
#include <iostream>
#include <string>
int main()
{
    std::wstring str = L"helloworld";
    std::intmax_t val = std::wcstoimax(str.c_str(), nullptr, 36);
    std::wcout << str << " in base 36 is " << val << " in base 10\n";
    wchar_t* nptr;
    val = std::wcstoimax(str.c_str(), &nptr, 30);
    if (nptr != &str[0] + str.size())
        std::wcout << 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

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