std::strtoimax, std::strtoumax

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

Регулярные выражения (C++11)

Атомарные примитивы (C++11)

Потоки (C++11)

 

Строки

Байтовые строки с завершающим нулем

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

char_traits

 

Однобайтовые строки с завершающим нулем

Функции
Операции с символами
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
Преобразования в цифровой формат
atof atoi atol atoll strtol strtoll	strtoul strtoull strtof strtod strtold
Операции со строками
strcpy
strncpy
strcat
strncat
strxfrm
Просмотр строк
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Операции с памятью
memchr
memcmp
memset
memcpy
memmove
Разное
strerror

 

Определено в заголовочном файле <cinttypes>
std::intmax_t strtoimax(const char* nptr, char** endptr, int base);		(начиная с C++11)
std::uintmax_t strtoumax(const char* nptr, char** endptr, int base);		(начиная с C++11)

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

Оригинал:

Interprets an integer value in a byte string pointed to by nptr.

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

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

• (необязательно) знак плюс или минус
• (необязательно) префикс (0), указывающий на то, что используется восьмеричная система счисления (применяется только в случае, когда base равен 8)
• (необязательно) префикс (0x или 0X), указывающий на то, что используется шестнадцатеричная система счисления (применяется только в случае, когда base равен 16)
• последовательность цифр

Набором корректных цифр для целочисленного значения в двоичной системе счисления является 01, для троичной 012, и так далее. Для оснований больше, чем 10, набор корректных цифр дополняется символами латинского алфавита, начиная с Aa для системы счисления с основанием 11, до Zz для системы счисления с основанием 36. Регистр символов значения не имеет.

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

Оригинал:

The functions sets the pointer pointed to by endptr to point to the character past the last character interpreted. If endptr is NULL, it is ignored.

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

Если nptr пуст или не иметь ожидаемого форму, преобразование не выполняется, и (если enptr не NULL) значение nptr хранится в объекте, на который указывает endptr.

Оригинал:

If the nptr is empty or does not have the expected form, no conversion is performed, and (if enptr is not NULL) the value of nptr is stored in the object pointed to by endptr.

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

Параметры

nptr	-	указатель с нулевым байтом строки должны интерпретироваться Оригинал: pointer to the null-terminated byte string to be interpreted Текст был переведён автоматически через Google Translate. Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
endptr	-	Указатель на указатель на символ . Оригинал: pointer to a pointer to character. Текст был переведён автоматически через Google Translate. Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
base	-	' Из базы интерпретировать целое значение Оригинал: base of the interpreted integer value Текст был переведён автоматически через Google Translate. Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

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

• В случае успеха, целое значение, соответствующее содержание str возвращается.

  Оригинал:

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

  Текст был переведён автоматически через Google Translate.
  Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
• Если преобразованное значение выпадает из диапазона соответствующий тип возвращения, диапазон ошибки (настройка 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 errno to ERANGE) and INTMAX_MAX, INTMAX_MIN, UINTMAX_MAX or ​0​ is returned, as appropriate.

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

  Оригинал:

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

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

Пример

#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

См. также

wcstoimax wcstoumax (C++11) (C++11)	преобразует широкий строку std::intmax_t или std::uintmax_t Оригинал: converts a wide string to std::intmax_t or std::uintmax_t Текст был переведён автоматически через Google Translate. Вы можете проверить и исправить перевод. Для инструкций кликните сюда. (функция)
strtol strtoll	преобразует байт строку в целое число Оригинал: converts a byte string to an integer value Текст был переведён автоматически через Google Translate. Вы можете проверить и исправить перевод. Для инструкций кликните сюда. (функция)
strtoul strtoull	преобразует байт строку в целое число без знака Оригинал: converts a byte string to an unsigned integer value Текст был переведён автоматически через Google Translate. Вы можете проверить и исправить перевод. Для инструкций кликните сюда. (функция)
C documentation for strtoimax, strtoumax