Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::stod — convertire il testo in double

std::stod, da <string>, converte in double il prefisso numerico di un testo. Il parametro facoltativo idx indica dove si è fermata la conversione; i caratteri rimanenti non causano automaticamente un errore.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#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, definita in <string>, accetta un std::string o un std::wstring e restituisce double. Le overload usano rispettivamente strtod e wcstod.

Il parametro facoltativo idx punta a un std::size_t. In caso di successo, riceve l'indice del primo carattere non convertito. Il valore predefinito nullptr disattiva il salvataggio di tale indice. È consentita la conversione di un prefisso: "42kg" produce 42 e lascia "kg". Per richiedere che venga elaborato tutto il testo, verifica pos == text.size(); anche gli spazi finali restano non convertiti.

Se non è possibile alcuna conversione, viene generata std::invalid_argument. std::stod lancia std::out_of_range se strtod o wcstod imposta errno a ERANGE oppure se il valore convertito non rientra nell'intervallo rappresentabile da double. In caso di underflow, la funzione sottostante può restituire un valore rappresentabile senza impostare errno a ERANGE. In tal caso, C++23 non richiede che std::stod lanci std::out_of_range. Dopo un'eccezione, non fare affidamento sul valore di idx.

L'esempio mostra la conversione riuscita di un prefisso e il rilevamento del suffisso rimanente. Il codice mostrato è stato eseguito senza modifiche e l'output standard ha coinciso esattamente con quello riportato.

Esempi

#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;
    }
}

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti