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

CKTIS / C++

std::to_string — converter um número em texto

std::to_string, de <string>, devolve a representação textual de um número como std::string. Esta entrada aborda C++23, incluindo as limitações da formatação de vírgula flutuante e a diferença em relação ao projeto de norma mais recente.

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

Sintaxe

#include <string>

std::string std::to_string(int val);
std::string std::to_string(unsigned val);
std::string std::to_string(long val);
std::string std::to_string(unsigned long val);
std::string std::to_string(long long val);
std::string std::to_string(unsigned long long val);
std::string std::to_string(float val);
std::string std::to_string(double val);
std::string std::to_string(long double val);

std::to_string(value) cria e devolve um std::string que contém a representação de um número. Requer <string> e não apresenta nada por si só. As suas sobrecargas aceitam int, unsigned, long, unsigned long, long long, unsigned long long, float, double e long double. Os números inteiros são escritos em decimal, com o sinal - para valores negativos.

Em C++23, a conversão comporta-se como a formatação correspondente através de sprintf. Os valores finitos de vírgula flutuante usam notação de vírgula fixa, com seis algarismos depois do separador decimal. O separador depende da localidade C global. Os valores pequenos podem ser arredondados para zero. Na localidade "C", std::to_string(1e-7) pode produzir "0.000000" com o arredondamento para o valor mais próximo. Se sprintf respeitar o modo de arredondamento ativo, o arredondamento por excesso pode, em vez disso, produzir "0.000001". Não consideres esta função uma representação sem perdas de números de vírgula flutuante arbitrários.

A função não aceita argumentos para escolher uma base ou precisão. Tal como no exemplo, podes concatenar o texto devolvido com outro std::string. Converte um número em texto; não analisa texto para o converter num número.

Âmbito da versão: esta entrada refere-se a C++23, em conformidade com a opção do compilador do repositório; o comportamento do ambiente de execução de produção não está atestado. O projeto atual nos endereços fornecidos já especifica o resultado como format("{}", val) e regista resultados de vírgula flutuante diferentes dos de C++23. Não apliques esse comportamento mais recente a C++23.

Exemplos

#include <iostream>
#include <string>

int main() {
    const std::string message = std::string("count=") + std::to_string(-42);
    std::cout << message << '\n';
}

Resultado

count=-42

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