CKTIS / C++
std::stoi — converter texto em int
std::stoi de <string> converte a parte inicial de um texto em int. Permite indicar a base numérica e obter a posição em que a conversão parou. Não é necessário consumir a cadeia inteira e os erros são comunicados através de exceções.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#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, declarada em <string>, devolve um valor int lido de um texto. Existem sobrecargas que aceitam std::string e std::wstring. O parâmetro base especifica a base numérica e tem o valor predefinido 10. Os únicos valores válidos são 0 (deteção automática da base) e os inteiros de 2 a 36, inclusive. Os restantes valores estão fora do domínio admitido pela conversão subjacente. Se base provier de uma fonte não fiável, valide o seu valor antes da chamada: capturar std::invalid_argument e std::out_of_range não é uma forma portável de validar a base.
A conversão pode parar antes do fim do texto: "42px" produz 42, não um erro. Após uma chamada bem-sucedida com idx != nullptr, a função guarda em *idx o índice do primeiro elemento não convertido. O valor predefinido nullptr ignora esta informação. Se for necessário consumir a cadeia inteira, verifique pos == text.size() após uma conversão bem-sucedida.
Se não for possível efetuar qualquer conversão, a função lança std::invalid_argument. Um resultado fora do intervalo de int, ou um erro de intervalo na conversão subjacente, causa std::out_of_range. Trate ambas as exceções ao processar dados não fiáveis; após uma exceção, não considere idx como um resultado da conversão.
O exemplo apresenta 42, depois o índice 2 e, por fim, o restante px. Demonstra a diferença entre converter com sucesso uma parte inicial e validar toda a entrada. A documentação de origem é um rascunho de trabalho em evolução, não uma edição fixa de C++23; o exemplo destina-se a uma verificação local em modo C++23, sem atestar um ambiente de produção.
Exemplos
#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";
}
}
Resultado
42 2 px
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.