Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes