База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::stod — преобразуване на текст в double

std::stod от <string> преобразува числовия префикс на текст в double. Незадължителният параметър idx показва къде е спрял процесът; останалите символи не водят автоматично до грешка.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#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 от <string> приема std::string или std::wstring и връща double. Претоварванията използват съответно strtod и wcstod.

Незадължителният параметър idx сочи към std::size_t. При успех в него се записва индексът на първия непреобразуван символ. Стойността по подразбиране nullptr изключва записването на този индекс. Преобразуването на префикс е позволено: "42kg" дава 42, като оставя "kg". За да изискваш обработване на целия текст, провери pos == text.size(); крайните интервали също остават непреобразувани.

Ако не може да се извърши преобразуване, се задейства std::invalid_argument. std::stod хвърля изключение std::out_of_range, ако strtod или wcstod зададе на errno стойност ERANGE или ако преобразуваната стойност е извън диапазона, представим от типа double. При загуба на значимост поради твърде малка абсолютна стойност (underflow) извиканата функция може да върне представима стойност, без да зададе на errno стойност ERANGE. В този случай C++23 не изисква std::stod да хвърли std::out_of_range. Не разчитай на стойността на idx след изключение.

Примерът показва успешно преобразуване на префикс и откриване на оставащия суфикс. При изпълнение на показания код без промени стандартният изход съвпадна точно с посочения.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници