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

CKTIS / C++

std::ios::boolalpha — valores booleanos em formato textual

Ativa a opção `std::ios::boolalpha` com `setf` para ler e escrever valores `bool` com os nomes das definições regionais do fluxo, em vez de usar números.

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

Sintaxe

#include <iostream>

// Inside a function:
const auto previous = std::cout.setf(std::ios::boolalpha);
std::cout << true;
std::cout.flags(previous);

std::ios::boolalpha é uma opção de formatação do tipo std::ios_base::fmtflags, não uma função. std::ios é um alias de std::basic_ios<char>. Tanto a opção como a função membro setf são declaradas em std::ios_base e estão disponíveis por herança.

std::cout.setf(std::ios::boolalpha) ativa esta opção sem alterar as outras e devolve o conjunto completo de opções anterior. A sobrecarga setf(flags, mask) substitui apenas os bits selecionados pela máscara. A chamada, por si só, não escreve nada: é um << posterior que insere o valor bool. Com as definições regionais clássicas, o resultado é true ou false em vez dos valores predefinidos 1 ou 0. Os inteiros, como o literal 1 de tipo int, continuam a ser escritos como números.

A opção pertence a esse fluxo e permanece ativa após a inserção seguinte. Usa unsetf(std::ios::boolalpha) para desativar apenas essa opção ou flags(previous) para repor todas as opções guardadas. A função livre std::boolalpha, usada como em std::cout << std::boolalpha, ativa a mesma opção. O exemplo chama setf diretamente.

Num fluxo de entrada, a mesma opção faz com que >> para bool procure uma correspondência com os nomes fornecidos pela faceta std::numpunct das definições regionais desse fluxo. Se a leitura não encontrar uma correspondência inequívoca, ativa failbit. Ativar a opção em std::cout não altera std::cin.

Exemplos

#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

`std::locale::classic()` fixa as grafias `true` e `false`. O programa escreve os valores antes e depois de ativar a opção, e novamente depois de repor as opções anteriores.

Lições relacionadas

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

Fontes