CKTIS / C++
std::stod — pretvorba teksta u double
std::stod iz <string> pretvara brojčani početak teksta u double. Neobavezni parametar idx pokazuje gdje je pretvorba stala; preostali znakovi ne uzrokuju automatski pogrešku.
Verzija: 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 zaglavlja <string> prihvaća std::string ili std::wstring i vraća double. Preopterećenja koriste strtod odnosno wcstod.
Neobavezni parametar idx pokazuje na std::size_t. U slučaju uspjeha prima indeks prvog nepretvorenog znaka. Zadana vrijednost nullptr isključuje pohranu tog indeksa. Pretvorba prefiksa je dopuštena: "42kg" daje 42, a "kg" ostaje. Ako želiš zahtijevati obradu cijelog teksta, provjeri pos == text.size(); i završni razmaci ostaju nepretvoreni.
Ako pretvorba nije moguća, dolazi do std::invalid_argument. std::stod baca iznimku std::out_of_range ako strtod ili wcstod postavi errno na ERANGE ili ako je pretvorena vrijednost izvan raspona vrijednosti koje tip double može prikazati. Pri potkoračenju raspona (underflow) pozvana funkcija može vratiti prikazivu vrijednost bez postavljanja errno na ERANGE. U tom slučaju C++23 ne zahtijeva da std::stod baci iznimku std::out_of_range. Nakon iznimke nemoj se oslanjati na vrijednost idx.
Primjer prikazuje uspješnu pretvorbu prefiksa i otkrivanje preostalog sufiksa. Pri izvođenju prikazanog koda bez izmjena standardni izlaz točno se podudarao s navedenim izlazom.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.