std:: strtol, std:: strtoll

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

Отбрасывает любые пробельные символы (определяемые вызовом 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 , используется шестнадцатеричная система, в противном случае используется десятичная система.

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

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

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

Параметры

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

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

Пример

#include <cerrno>
#include <cstdlib>
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    const char* p = "10 200000000000000000000000000000 30 -40";
    std::cout << "Parsing " << std::quoted(p) << ":\n";
    for (;;)
    {
        // errno может быть установлен в любое ненулевое значение вызовом библиотечной функции
        // независимо от наличия ошибки, поэтому его нужно сбросить
        // чтобы проверить ошибку, установленную strtol
        errno = 0;
        char* p_end{};
        const long i = std::strtol(p, &p_end, 10);
        if (p == p_end)
            break;
        const bool range_error = errno == ERANGE;
        const std::string extracted(p, p_end - p);
        p = p_end;
        std::cout << "Extracted " << std::quoted(extracted)
                  << ", strtol returned " << i << '.';
        if (range_error)
            std::cout << "\n  Range error occurred.";
        std::cout << '\n';
    }
}

Parsing "10 200000000000000000000000000000 30 -40":
Extracted "10", strtol returned 10.
Extracted " 200000000000000000000000000000", strtol returned 9223372036854775807.
  Range error occurred.
Extracted " 30", strtol returned 30.
Extracted " -40", strtol returned -40.

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