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

CKTIS / C++

std::stod — convertir texto a double

std::stod, de <string>, convierte el prefijo numérico de un texto a double. El parámetro opcional idx indica dónde se detuvo la conversión; los caracteres restantes no provocan un error automáticamente.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <string>

// Overload synopsis (declared by <string>):
// namespace std {
//     double stod(const std::string& str, std::size_t* idx = nullptr);
//     double stod(const std::wstring& str, std::size_t* idx = nullptr);
// }

std::stod, de <string>, acepta un std::string o un std::wstring y devuelve double. Las sobrecargas usan strtod y wcstod, respectivamente.

El parámetro opcional idx apunta a un std::size_t. Si la conversión tiene éxito, recibe el índice del primer carácter no convertido. El valor predeterminado nullptr desactiva el almacenamiento de ese índice. Se permite convertir un prefijo: "42kg" produce 42 y deja "kg". Para exigir que se consuma todo el texto, comprueba pos == text.size(); los espacios en blanco finales también quedan sin convertir.

Si no se puede realizar ninguna conversión, se produce std::invalid_argument. std::stod lanza std::out_of_range si strtod o wcstod asigna ERANGE a errno, o si el valor convertido queda fuera del rango representable por double. En caso de subdesbordamiento, la función subyacente puede devolver un valor representable sin asignar ERANGE a errno. En ese caso, C++23 no exige que std::stod lance std::out_of_range. No te fíes del valor de idx después de una excepción.

El ejemplo muestra una conversión correcta de un prefijo y cómo detectar el sufijo restante. Al ejecutar el código mostrado sin cambios, la salida estándar coincidió exactamente con la salida indicada.

Ejemplos

#include <cstddef>
#include <iostream>
#include <stdexcept>
#include <string>

int main() {
    const std::string text = "42kg";
    std::size_t pos = 0;

    try {
        const double value = std::stod(text, &pos);
        std::cout << "value=" << value << '\n';
        std::cout << "pos=" << pos << '\n';
        std::cout << "rest=" << text.substr(pos) << '\n';
        std::cout << "complete=" << (pos == text.size()) << '\n';
    } catch (const std::invalid_argument&) {
        std::cout << "invalid_argument\n";
        return 1;
    } catch (const std::out_of_range&) {
        std::cout << "out_of_range\n";
        return 1;
    }
}

Resultado

value=42
pos=2
rest=kg
complete=0

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