CKTIS / C++
std::stod — pretvorba besedila v double
std::stod iz <string> pretvori številski začetni del besedila v double. Izbirni parameter idx pove, kje se je pretvorba ustavila; preostali znaki samodejno ne povzročijo napake.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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 iz glave <string> sprejme std::string ali std::wstring in vrne double. Preobremenitvi uporabljata strtod oziroma wcstod.
Izbirni parameter idx kaže na std::size_t. Ob uspehu prejme indeks prvega nepretvorjenega znaka. Privzeta vrednost nullptr onemogoči shranjevanje tega indeksa. Pretvorba predpone je dovoljena: "42kg" da rezultat 42, pri čemer ostane "kg". Če želiš zahtevati porabo celotnega besedila, preveri pos == text.size(); tudi končni presledki ostanejo nepretvorjeni.
Če pretvorba ni mogoča, pride do std::invalid_argument. std::stod sproži izjemo std::out_of_range, če strtod ali wcstod nastavi errno na ERANGE ali če je pretvorjena vrednost zunaj območja vrednosti, ki jih lahko predstavi tip double. Pri podteku lahko klicana funkcija vrne predstavljivo vrednost, ne da bi nastavila errno na ERANGE. V tem primeru C++23 ne zahteva, da std::stod sproži izjemo std::out_of_range. Po izjemi se ne zanašaj na vrednost idx.
Primer prikazuje uspešno pretvorbo predpone in zaznavanje preostale pripone. Pri zagonu prikazane kode brez sprememb se je standardni izhod natančno ujemal z navedenim izpisom.
Primeri
#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;
}
}
Rezultat
value=42 pos=2 rest=kg complete=0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.