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

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.

Fontes