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
- Working Draft, Standard for Programming Language C++ (WG21 N4950)
- [iosfwd.syn] Header <iosfwd> synopsis
- [ios.overview] Class template basic_ios overview
- [ios.fmtflags] Type ios_base::fmtflags
- [fmtflags.state] State functions
- [basic.ios.cons] Constructors and initial stream state
- [fmtflags.manip] fmtflags manipulators
- [ostream.inserters.arithmetic] Arithmetic inserters
- [facet.num.put.virtuals] num_put virtual functions
- [facet.num.get.virtuals] num_get virtual functions
- [facet.numpunct.virtuals] numpunct virtual functions
- [locale.statics] Static members of locale