CKTIS / C++
std::stoi — преобразуване на текст в int
std::stoi от <string> преобразува началната част на текст в int. Позволява да зададете числова основа и да получите позицията, до която е стигнало преобразуването. Не е необходимо да се обработи целият низ; грешките се съобщават чрез изключения.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <string>
/* Overload synopsis (declarations provided by <string>):
namespace std {
int stoi(const string& str, size_t* idx = nullptr, int base = 10);
int stoi(const wstring& str, size_t* idx = nullptr, int base = 10);
}
*/std::stoi, декларирана в <string>, връща стойност от тип int, прочетена от текст. Има претоварени версии за std::string и std::wstring. Параметърът base задава числовата основа, като стойността по подразбиране е 10. Допустимите стойности са само 0 (автоматично разпознаване на основата) и целите числа от 2 до 36 включително. Други стойности са извън допустимата област на базовото преобразуване. Ако base идва от ненадежден източник, проверете стойността му преди извикването: прихващането на std::invalid_argument и std::out_of_range не е преносим начин за проверка на основата.
Преобразуването може да спре преди края на текста: "42px" дава 42, а не грешка. След успешно извикване с idx != nullptr функцията записва в *idx индекса на първия непреобразуван елемент. Стойността по подразбиране nullptr пропуска тази информация. Ако трябва да се обработи целият низ, проверете pos == text.size() след успешно преобразуване.
Ако не е възможно преобразуване, функцията хвърля std::invalid_argument. Резултат извън диапазона на int или грешка в диапазона на базовото преобразуване причинява std::out_of_range. Обработвайте и двете изключения при работа с ненадеждни данни; след изключение не приемайте idx за резултат от преобразуването.
Примерът извежда 42, след това индекса 2 и накрая останалото px. Той показва разликата между успешно преобразуване на начална част и проверка на целия вход. Изходната документация е актуален работен проект, а не фиксирано издание на C++23; примерът е предназначен за локална проверка в режим C++23, без да удостоверява производствена среда.
Примери
#include <cstddef>
#include <iostream>
#include <stdexcept>
#include <string>
int main() {
const std::string text = "42px";
std::size_t pos = 0;
try {
const int value = std::stoi(text, &pos, 10);
std::cout << value << '\n';
std::cout << pos << '\n';
std::cout << text.substr(pos) << '\n';
} catch (const std::invalid_argument&) {
std::cout << "invalid_argument\n";
} catch (const std::out_of_range&) {
std::cout << "out_of_range\n";
}
}
Резултат
42 2 px
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.