std::strtoul, std::strtoull

unsigned long      strtoul ( const char* str, char** str_end, int base );

unsigned long long strtoull( const char* str, char** str_end, int base );

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

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

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

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

Параметры

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

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

Пример

#include <cstdlib>
#include <errno.h>
#include <iostream>
#include <string>

int main()
{
    const char* p = "10 200000000000000000000000000000 30 -40 - 42";
    char* end = nullptr;
    std::cout << "Parsing '" << p << "':\n";
    for (unsigned long i = std::strtoul(p, &end, 10);
        p != end;
        i = std::strtoul(p, &end, 10))
    {
        std::cout << "'" << std::string(p, end - p) << "' -> ";
        p = end;
        if (errno == ERANGE)
        {
            errno = 0;
            std::cout << "range error, got ";
        }
        std::cout << i << '\n';
    }
    std::cout << "After the loop p points to '" << p << "'\n";
}

Parsing '10 200000000000000000000000000000 30 -40 - 42':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 18446744073709551615
' 30' -> 30
' -40' -> 18446744073709551576
After the loop p points to ' - 42'

См. также