CKTIS / C++
std::stod — převod textu na double
std::stod z <string> převádí číselný začátek textu na double. Volitelný parametr idx udává, kde se převod zastavil; zbývající znaky automaticky nezpůsobí chybu.
Verze: 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 z hlavičky <string> přijímá std::string nebo std::wstring a vrací double. Jednotlivá přetížení používají strtod a wcstod.
Volitelný parametr idx ukazuje na std::size_t. Při úspěchu do něj uloží index prvního nepřevedeného znaku. Výchozí hodnota nullptr ukládání tohoto indexu vypíná. Převod předpony je povolen: "42kg" vytvoří hodnotu 42 a ponechá "kg". Chceš-li vyžadovat zpracování celého textu, zkontroluj pos == text.size(); nepřevedené zůstanou i koncové bílé znaky.
Pokud se nepodaří provést žádný převod, dojde k std::invalid_argument. std::stod vyvolá výjimku std::out_of_range, pokud strtod nebo wcstod nastaví errno na ERANGE nebo pokud je převedená hodnota mimo rozsah hodnot reprezentovatelných typem double. Při podtečení může volaná funkce vrátit reprezentovatelnou hodnotu, aniž by nastavila errno na ERANGE. V takovém případě C++23 nevyžaduje, aby std::stod vyvolala výjimku std::out_of_range. Po výjimce se na hodnotu idx nespoléhej.
Příklad ukazuje úspěšný převod předpony a zjištění zbývajícího suffixu. Při spuštění zobrazeného kódu beze změn se standardní výstup přesně shodoval s uvedeným výstupem.
Příklady
#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;
}
}
Výsledek
value=42 pos=2 rest=kg complete=0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.