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.