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

CKTIS / C++

`std::basic_ios::setf`: definir as opções de formatação de um fluxo

`setf` altera as opções de formatação de um fluxo. Com `std::ios::boolalpha` e a configuração regional clássica, os valores `bool` são apresentados como `true` e `false`.

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

Sintaxe

// Declared in std::ios_base (<ios>); inherited by std::basic_ios.
std::ios_base::fmtflags setf(std::ios_base::fmtflags flags);
std::ios_base::fmtflags setf(std::ios_base::fmtflags flags,
                            std::ios_base::fmtflags mask);

std::basic_ios::setf é uma função membro herdada: ambas as sobrecargas são declaradas em std::ios_base. std::ios é um alias de std::basic_ios<char>, pelo que std::ios::boolalpha designa a mesma opção herdada que std::ios_base::boolalpha.

setf(flags) ativa os bits indicados e deixa os restantes inalterados. setf(flags, mask) substitui apenas os bits selecionados por mask pelos bits correspondentes de flags. Usa, por exemplo, out.setf(std::ios_base::hex, std::ios_base::basefield) para mudar a base dos números inteiros sem deixar ativa a opção da base anterior. Ambas as sobrecargas devolvem o conjunto completo de opções anterior como std::ios_base::fmtflags, e não um código de erro ou uma referência ao fluxo.

std::cout.setf(std::ios::boolalpha) não escreve nada. É o operador de inserção no fluxo << que usa a opção quando escreve posteriormente um valor bool. Com a configuração regional clássica, o resultado é true ou false em vez dos habituais 1 ou 0; outra configuração regional pode usar nomes diferentes. std::cout << std::boolalpha ativa a mesma opção através de um manipulador que é uma função não membro; o exemplo não o usa. A opção não altera a apresentação dos números inteiros 1 e 0.

A opção continua ativa nesse fluxo depois de <<. Usa out.unsetf(std::ios::boolalpha) para desativar apenas essa opção, ou out.flags(previous) para repor todo o conjunto guardado.

Exemplos

#include <ios>
#include <iostream>
#include <locale>

int main() {
    std::cout.imbue(std::locale::classic());
    std::cout << true << ' ' << false << '\n';

    const auto previous = std::cout.setf(std::ios::boolalpha);
    std::cout << true << ' ' << false << '\n';

    std::cout.flags(previous);
    std::cout << true << ' ' << false << '\n';
}

Resultado

1 0
true false
1 0

O programa seleciona explicitamente `std::locale::classic()`. As linhas esperadas são `1 0`, depois `true false` e, após a reposição das opções, novamente `1 0`.

Lições relacionadas

  • C++ · Lição 5 · Avançado · Versão: 3

Fontes