Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::stod — konwersja tekstu na double

std::stod z nagłówka <string> przekształca liczbowy początek tekstu na double. Opcjonalny parametr idx wskazuje, gdzie konwersja się skończyła; pozostałe znaki nie powodują automatycznie błędu.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#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 nagłówka <string> przyjmuje std::string albo std::wstring i zwraca double. Przeciążenia korzystają odpowiednio z strtod i wcstod.

Opcjonalny idx jest wskaźnikiem na std::size_t. Po sukcesie otrzymuje indeks pierwszego nieprzetworzonego znaku. Domyślne nullptr wyłącza zapis indeksu. Konwersja prefiksu jest dozwolona: "42kg" daje 42, pozostawiając "kg". Aby wymagać zużycia całego tekstu, sprawdź pos == text.size(); końcowe białe znaki także pozostają nieprzetworzone.

Brak konwersji powoduje std::invalid_argument. std::stod zgłasza std::out_of_range, jeśli strtod lub wcstod ustawi errno na ERANGE albo jeśli przekonwertowana wartość wykracza poza zakres wartości reprezentowalnych przez double. Przy niedomiarze funkcja bazowa może zwrócić wartość reprezentowalną bez ustawienia errno na ERANGE. W takim przypadku C++23 nie wymaga zgłoszenia std::out_of_range. Nie polegaj na wartości idx po wyjątku.

Przykład pokazuje udaną konwersję prefiksu i wykrycie pozostałego sufiksu. Po uruchomieniu pokazanego kodu bez zmian standardowe wyjście dokładnie odpowiadało podanemu wynikowi.

Przykłady

#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;
    }
}

Wynik

value=42
pos=2
rest=kg
complete=0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła