CKTIS / C++
std::stod — tekst omzetten naar double
std::stod uit <string> zet een numeriek voorvoegsel van tekst om naar double. De optionele parameter idx geeft aan waar de omzetting is gestopt; resterende tekens veroorzaken niet automatisch een fout.
Versie: 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 uit <string> accepteert een std::string of std::wstring en retourneert double. De overloads gebruiken respectievelijk strtod en wcstod.
De optionele parameter idx wijst naar een std::size_t. Bij succes krijgt deze de index van het eerste niet-omgezette teken. De standaardwaarde nullptr schakelt het opslaan van die index uit. Omzetting van een voorvoegsel is toegestaan: "42kg" levert 42 op en laat "kg" over. Controleer pos == text.size() als de volledige tekst moet worden verwerkt; ook afsluitende witruimte blijft ongeconverteerd.
Als er geen omzetting plaatsvindt, wordt std::invalid_argument gegenereerd. std::stod werpt std::out_of_range op als strtod of wcstod de waarde ERANGE aan errno toekent of als de omgezette waarde buiten het bereik ligt dat double kan weergeven. Bij underflow kan de onderliggende functie een representeerbare waarde teruggeven zonder errno op ERANGE in te stellen. In dat geval schrijft C++23 niet voor dat std::stod de uitzondering std::out_of_range opwerpt. Vertrouw na een uitzondering niet op de waarde van idx.
Het voorbeeld laat zien hoe een voorvoegsel succesvol wordt omgezet en hoe het resterende achtervoegsel wordt vastgesteld. De getoonde code is ongewijzigd uitgevoerd en de standaarduitvoer kwam exact overeen met de opgegeven uitvoer.
Voorbeelden
#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;
}
}
Resultaat
value=42 pos=2 rest=kg complete=0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.