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

CKTIS / C++

std::ios_base: flags de formatação e precisão

std::ios_base armazena o estado de formatação de um fluxo. Aprende a diferença entre as sobrecargas de setf, o significado de precision e como ativar fixed e boolalpha, preservando as definições para as restaurar mais tarde.

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

Sintaxe

std::ios_base::fmtflags setf(std::ios_base::fmtflags fmtfl);
std::ios_base::fmtflags setf(std::ios_base::fmtflags fmtfl, std::ios_base::fmtflags mask);
std::streamsize precision() const;
std::streamsize precision(std::streamsize prec);

stream.setf(std::ios_base::fixed, std::ios_base::floatfield);
stream.precision(2);
stream.setf(std::ios_base::boolalpha);

std::ios_base armazena as definições de formatação de um fluxo individual. std::ios_base::setf e std::ios_base::precision são funções membro; std::ios_base::fixed e std::ios_base::boolalpha são flags fmtflags, não os manipuladores std::fixed e std::boolalpha. As definições permanecem ativas até serem alteradas novamente.

setf(fmtfl) adiciona os bits indicados sem limpar os restantes. setf(fmtfl, mask) limpa primeiro os bits selecionados por mask e, em seguida, define fmtfl & mask. Ambas as sobrecargas devolvem o conjunto completo de flags anterior. Para selecionar a notação de vírgula fixa, usa setf(std::ios_base::fixed, std::ios_base::floatfield): adicionar apenas fixed não limpa scientific; se ambos os bits estiverem definidos, é selecionada a notação hexadecimal de vírgula flutuante.

precision() consulta a precisão, enquanto precision(n) a define e devolve o valor anterior. No modo fixed, a precisão especifica o número de algarismos após o separador decimal; no modo de vírgula flutuante predefinido, especifica o número de algarismos significativos. Não altera o valor numérico armazenado. boolalpha ativa a inserção e extração textual de bool; os nomes dependem da configuração regional. Com std::locale::classic(), são true e false, em vez da saída numérica 1 e 0.

O exemplo usa um fluxo local com std::locale::classic() para estabilizar o separador decimal e os nomes booleanos. Guarda as flags e a precisão e, depois, restaura-as separadamente através de flags(savedFlags) e precision(savedPrecision). Ao trabalhar com um fluxo partilhado, prevê também o restauro das definições caso ocorra uma exceção, por exemplo, com um guardião RAII.

Exemplos

#include <iostream>
#include <locale>
#include <sstream>

int main() {
    std::ostringstream out;
    out.imbue(std::locale::classic());

    const auto savedFlags = out.setf(
        std::ios_base::fixed, std::ios_base::floatfield);
    const auto savedPrecision = out.precision(2);
    out.setf(std::ios_base::boolalpha);

    out << 12.5 << ' ' << true << ' ' << false << '\n';

    out.flags(savedFlags);
    out.precision(savedPrecision);
    out << 12.5 << ' ' << true << ' ' << false << '\n';

    std::cout << out.str();
}

Resultado

12.50 true false
12.5 1 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.

Fontes