std::strtoimax, std::strtoumax

Эта страница была переведена автоматически с английской версии вики используя Переводчик Google. Перевод может содержать ошибки и странные формулировки. Наведите курсор на текст, чтобы увидеть оригинал. Щёлкните здесь, чтобы увидеть английскую версию этой страницы. (Вы можете помочь в исправлении ошибок и улучшении перевода. Для инструкций перейдите по ссылке.)

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

  Оригинал:

  If successful, an integer value corresponding to the contents of str is returned.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
• Если преобразованное значение выпадает из диапазона соответствующий тип возвращения, диапазон ошибки (настройка [[cpp/error/errno|errno]] в ERANGE) и INTMAX_MAX, INTMAX_MIN, UINTMAX_MAX или ​0​ возвращается, в случае необходимости.

  Оригинал:

  If the converted value falls out of range of corresponding return type, a range error occurs (setting [[cpp/error/errno|errno]] to ERANGE) and INTMAX_MAX, INTMAX_MIN, UINTMAX_MAX or ​0​ is returned, as appropriate.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
• Если преобразование не может быть выполнено, ​0​ возвращается.

  Оригинал:

  If no conversion can be performed, ​0​ is returned.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

[править] Пример

#include <iostream>
#include <string>
#include <cinttypes>
 
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

[править] См. также