WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::stod — Text in double umwandeln

std::stod aus <string> wandelt einen numerischen Anfangsteil eines Textes in double um. Der optionale Parameter idx zeigt an, an welcher Stelle die Umwandlung endete; verbleibende Zeichen führen nicht automatisch zu einem Fehler.

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

Syntax

#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 aus <string> akzeptiert ein std::string oder std::wstring und gibt double zurück. Die Überladungen verwenden jeweils strtod und wcstod.

Der optionale Parameter idx zeigt auf ein std::size_t. Bei Erfolg erhält er den Index des ersten nicht umgewandelten Zeichens. Der Standardwert nullptr verhindert, dass dieser Index gespeichert wird. Eine Umwandlung eines Präfixes ist zulässig: "42kg" ergibt 42; "kg" bleibt übrig. Wenn der gesamte Text verarbeitet werden muss, prüfe pos == text.size(); auch abschließende Leerzeichen bleiben unkonvertiert.

Wenn keine Umwandlung möglich ist, wird std::invalid_argument ausgelöst. std::stod löst std::out_of_range aus, wenn strtod oder wcstod den Wert von errno auf ERANGE setzt oder wenn der umgewandelte Wert außerhalb des darstellbaren Wertebereichs von double liegt. Bei einem Unterlauf kann die zugrunde liegende Funktion einen darstellbaren Wert zurückgeben, ohne errno auf ERANGE zu setzen. In diesem Fall schreibt C++23 nicht vor, dass std::stod die Ausnahme std::out_of_range auslöst. Verlasse dich nach einer Ausnahme nicht auf den Wert von idx.

Das Beispiel zeigt eine erfolgreiche Präfixumwandlung und erkennt den verbleibenden Rest. Bei der unveränderten Ausführung des gezeigten Codes stimmte die Standardausgabe exakt mit der angegebenen Ausgabe überein.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen