CKTIS / C++
std::stod — prevod textu na double
std::stod z <string> prevádza číselný začiatok textu na double. Voliteľný parameter idx označuje, kde sa prevod zastavil; zostávajúce znaky automaticky nespôsobia chybu.
Verzia: 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 z hlavičky <string> prijíma std::string alebo std::wstring a vracia double. Jednotlivé preťaženia používajú strtod a wcstod.
Voliteľný parameter idx ukazuje na std::size_t. Pri úspechu doň uloží index prvého neprevedeného znaku. Predvolená hodnota nullptr vypína ukladanie tohto indexu. Prevod predpony je povolený: "42kg" vytvorí hodnotu 42 a ponechá "kg". Ak chceš vyžadovať spracovanie celého textu, skontroluj pos == text.size(); neprevedené zostanú aj koncové biele znaky.
Ak sa nepodarí vykonať žiadny prevod, dôjde k std::invalid_argument. std::stod vyvolá výnimku std::out_of_range, ak strtod alebo wcstod nastaví errno na ERANGE alebo ak je prevedená hodnota mimo rozsahu hodnôt reprezentovateľných typom double. Pri podtečení môže volaná funkcia vrátiť reprezentovateľnú hodnotu bez toho, aby nastavila errno na ERANGE. V takom prípade C++23 nevyžaduje, aby std::stod vyvolala výnimku std::out_of_range. Po výnimke sa na hodnotu idx nespoliehaj.
Príklad ukazuje úspešný prevod predpony a zistenie zostávajúceho suffixu. Pri spustení zobrazeného kódu bez zmien sa štandardný výstup presne zhodoval s uvedeným výstupom.
Prí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ýsledok
value=42 pos=2 rest=kg complete=0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.