Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::stod — converter texto para double

std::stod, de <string>, converte o prefixo numérico de um texto para double. O parâmetro opcional idx indica onde a conversão terminou; os caracteres restantes não causam automaticamente um erro.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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, de <string>, aceita um std::string ou um std::wstring e devolve double. As sobrecargas utilizam strtod e wcstod, respetivamente.

O parâmetro opcional idx aponta para um std::size_t. Em caso de sucesso, recebe o índice do primeiro carácter não convertido. O valor predefinido nullptr desativa o armazenamento desse índice. É permitida a conversão de um prefixo: "42kg" produz 42 e deixa "kg". Para exigir que todo o texto seja consumido, verifica pos == text.size(); os espaços em branco finais também ficam por converter.

Se não for possível efetuar qualquer conversão, ocorre std::invalid_argument. std::stod lança std::out_of_range se strtod ou wcstod atribuir ERANGE a errno ou se o valor convertido estiver fora do intervalo representável por double. Em caso de underflow, a função subjacente pode devolver um valor representável sem atribuir ERANGE a errno. Nesse caso, C++23 não exige que std::stod lance std::out_of_range. Não confies no valor de idx após uma exceção.

O exemplo demonstra uma conversão bem-sucedida de um prefixo e a deteção do sufixo restante. O código apresentado foi executado sem alterações e a saída padrão coincidiu exatamente com o resultado apresentado.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes