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

CKTIS / C++

Formatar números com cout.setf e setprecision(2)

Configura `std::cout` para apresentar números em notação de vírgula fixa com duas casas decimais. Aprende a usar a máscara `floatfield` e a repor o formato anterior.

Versão: ISO C++23; implementation support may vary

Sintaxe

// ISO C++23; implementation support may vary
#include <iostream>
#include <iomanip>

// Inside a function, assuming standard stream formatting:
std::cout.setf(std::ios::fixed, std::ios::floatfield);
std::cout << std::setprecision(2) << 12.5 << '\n';

// Equivalent manipulator form:
std::cout << std::fixed << std::setprecision(2) << 12.5 << '\n';

std::cout é o fluxo de saída padrão declarado em <iostream>. A forma cout.setf(ios::fixed) pressupõe que os nomes cout e ios de std estão disponíveis sem qualificação, por exemplo através de declarações using. std::ios é um alias de std::basic_ios<char>; a função membro setf e as opções de formatação vêm de std::ios_base. O ponto seleciona um membro do fluxo e :: qualifica um nome pelo seu âmbito.

Com um argumento, setf(std::ios::fixed) ativa o bit fixed sem limpar scientific. Se os dois bits estiverem ativos, a formatação padrão usa notação hexadecimal, não notação decimal de vírgula fixa. std::cout.setf(std::ios::fixed, std::ios::floatfield) limpa os bits abrangidos pela máscara floatfield e depois ativa apenas fixed dentro dessa máscara, sem alterar as restantes opções. Ambas as sobrecargas devolvem as opções anteriores, não o fluxo. std::cout << std::fixed tem o mesmo efeito que a chamada com máscara.

std::cout << std::setprecision(2) usa o manipulador de <iomanip> para definir a precisão do fluxo. Em modo fixed, são dois algarismos depois do separador decimal, incluindo zeros finais; em modo defaultfloat, a precisão refere-se a algarismos significativos, não a casas decimais. A formatação altera o texto, não o valor guardado. O modo e a precisão mantêm-se nesse fluxo até serem alterados. Para uma alteração temporária, guarda flags() e precision() e repõe ambos os valores no fim. As definições regionais do fluxo determinam o separador decimal.

Exemplos

#include <iomanip>
#include <iostream>
#include <locale>

int main() {
    std::cout.imbue(std::locale::classic());
    const auto saved_flags = std::cout.flags();
    const auto saved_precision = std::cout.precision();

    std::cout << std::scientific;
    std::cout.setf(std::ios::fixed, std::ios::floatfield);
    std::cout << std::setprecision(2) << 12.5 << '\n';

    std::cout << std::scientific;
    std::cout << std::fixed << std::setprecision(2) << 3.0 << '\n';

    std::cout.flags(saved_flags);
    std::cout.precision(saved_precision);
    std::cout << 12.5 << '\n';
}

Resultado

12.50
3.00
12.5

As duas primeiras linhas passam de `scientific` para `fixed`, primeiro com `setf` e a máscara, depois com `std::fixed`. Depois de repostas as opções e a precisão, a terceira linha usa o formato inicial. As definições regionais clássicas usam um ponto decimal.

Lições relacionadas

  • C++ · Lição 22 · Intermédio · Versão: 2

Fontes