CKTIS / C++
std::setprecision — precisão da formatação numérica
std::setprecision, de <iomanip>, define a precisão de um fluxo. Com std::defaultfloat, uma precisão positiva define o número máximo de algarismos significativos. Com std::fixed e std::scientific, uma precisão não negativa define o número de algarismos após o separador decimal; se for negativa, são usados seis algarismos por omissão. A definição mantém-se ativa nas operações seguintes.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <iomanip>
// std::setprecision(int n) returns an object of unspecified type.
out << std::setprecision(n);
in >> std::setprecision(n);std::setprecision(n), de <iomanip>, cria um manipulador cujo tipo de retorno não é especificado pela norma. A expressão out << std::setprecision(n) funciona como out.precision(n) e permite continuar o encadeamento com <<. Altera o estado de formatação do fluxo, não o valor numérico armazenado.
O significado de n depende do modo. Com std::defaultfloat, para valores positivos, é o número máximo de algarismos significativos; a saída pode usar notação normal ou exponencial e, em geral, os zeros finais são omitidos. Para n >= 0, std::fixed escreve n algarismos após o separador decimal e std::scientific escreve o mesmo número de algarismos após o separador na mantissa da notação exponencial. O manipulador também aceita valores negativos de n e guarda-os no fluxo. Em ambos os modos, a formatação trata uma precisão negativa como se não tivesse sido indicada e usa, por omissão, seis algarismos após o separador decimal. Com std::hexfloat, a precisão é ignorada.
A formatação arredonda a representação textual, em vez de simplesmente truncar algarismos. Aumentar a precisão não melhora a exatidão do valor armazenado. O manipulador não define a largura do campo nem altera a formatação da saída de inteiros. O separador decimal depende da localidade do fluxo.
A definição mantém-se ativa até ser alterada. std::defaultfloat muda o modo, mas não repõe uma precisão anterior. Em código auxiliar, guarde e restaure precision() e, se o modo for alterado, também flags(). A sintaxe in >> std::setprecision(n) é válida e define o estado de precisão do fluxo de entrada; não limita o número de algarismos consumidos na leitura normal de um número de vírgula flutuante.
Exemplos
#include <iomanip>
#include <iostream>
#include <locale>
int main() {
std::cout.imbue(std::locale::classic());
const double value = 12.375;
const auto oldPrecision = std::cout.precision();
const auto oldFlags = std::cout.flags();
std::cout << std::defaultfloat << std::setprecision(4)
<< value << '\n';
std::cout << std::fixed << std::setprecision(2)
<< value << '\n';
std::cout << 1.5 << '\n';
std::cout << std::scientific << value << '\n';
std::cout.precision(oldPrecision);
std::cout.flags(oldFlags);
}
Resultado
12.38 12.38 1.50 1.24e+01
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.