std::wcstoul, std::wcstoull

unsigned long      wcstoul ( const wchar_t* str, wchar_t** str_end, int base );

unsigned long long wcstoull( const wchar_t* str, wchar_t** str_end, int base );

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

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

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

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

Функции устанавливает указатель, на который указывает str_end, на символ, следующий за последним интерпретированным символом. Если str_end — нулевой указатель, он игнорируется.

Параметры

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

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

Пример

#include <cwchar>
#include <errno.h>
#include <iostream>
#include <string>
 
int main()
{
    const wchar_t* p = L"10 200000000000000000000000000000 30 40";
    wchar_t* end;
    std::wcout << "Parsing L'" << p << "':\n";
    for (unsigned long i = std::wcstoul(p, &end, 10);
         p != end;
         i = std::wcstoul(p, &end, 10))
    {
        std::wcout << '\'' << std::wstring(p, end - p) << "' -> ";
        p = end;
        if (errno == ERANGE)
        {
            std::wcout << "range error, got ";
            errno = 0;
        }
        std::wcout << i << '\n';
    }
}

Parsing L'10 200000000000000000000000000000 30 40':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 18446744073709551615
' 30' -> 30
' 40' -> 40

См. также