Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::stod — convertir du texte en double

std::stod, de <string>, convertit le préfixe numérique d’un texte en double. Le paramètre facultatif idx indique où la conversion s’est arrêtée ; les caractères restants ne provoquent pas automatiquement une erreur.

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

Syntaxe

#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, fourni par <string>, accepte un std::string ou un std::wstring et renvoie un double. Les surcharges utilisent respectivement strtod et wcstod.

Le paramètre facultatif idx pointe vers un std::size_t. En cas de réussite, il reçoit l’indice du premier caractère non converti. La valeur par défaut nullptr désactive l’enregistrement de cet indice. La conversion d’un préfixe est autorisée : "42kg" produit 42 et laisse "kg". Pour exiger la consommation de tout le texte, vérifiez pos == text.size() ; les espaces finaux restent eux aussi non convertis.

Si aucune conversion n’est possible, std::invalid_argument est levée. std::stod lève std::out_of_range si strtod ou wcstod donne à errno la valeur ERANGE, ou si la valeur convertie est hors de la plage représentable par double. En cas de sous-dépassement, la fonction sous-jacente peut renvoyer une valeur représentable sans donner à errno la valeur ERANGE. Dans ce cas, C++23 n’exige pas que std::stod lève std::out_of_range. Ne vous fiez pas à la valeur de idx après une exception.

L’exemple montre la réussite de la conversion d’un préfixe et la détection du suffixe restant. Le code présenté a été exécuté sans modification et sa sortie standard correspondait exactement à la sortie indiquée.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources