CKTIS / C++
std::stoi — convertir texto a int
std::stoi de <string> convierte la parte inicial de un texto a int. Permite especificar la base numérica y obtener la posición en la que se detuvo la conversión. No es necesario consumir toda la cadena y los errores se notifican mediante excepciones.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#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 en <string>, devuelve un valor int leído de un texto. Hay sobrecargas que aceptan std::string y std::wstring. El parámetro base especifica la base numérica y, de forma predeterminada, vale 10. Los únicos valores válidos son 0 (detección automática de la base) y los enteros de 2 a 36, ambos incluidos. Los demás valores quedan fuera del dominio admitido por la conversión subyacente. Si base procede de una fuente no fiable, comprueba su valor antes de la llamada: capturar std::invalid_argument y std::out_of_range no es una forma portable de validar la base.
La conversión puede detenerse antes del final del texto: "42px" produce 42, no un error. Tras una llamada correcta con idx != nullptr, la función guarda en *idx el índice del primer elemento no convertido. El valor predeterminado nullptr omite esta información. Si es necesario consumir toda la cadena, comprueba pos == text.size() después de una conversión correcta.
Si no es posible realizar ninguna conversión, la función lanza std::invalid_argument. Un resultado fuera del rango de int, o un error de rango en la conversión subyacente, provoca std::out_of_range. Gestiona ambas excepciones al procesar datos no confiables; después de una excepción, no trates idx como un resultado de conversión.
El ejemplo muestra 42, luego el índice 2 y, por último, el resto px. Ilustra la diferencia entre convertir correctamente una parte inicial y validar toda la entrada. La documentación fuente es un borrador de trabajo en evolución, no una edición fija de C++23; el ejemplo está pensado para comprobarse localmente en modo C++23, sin certificar un entorno de producción.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.