CKTIS / C++
std::boolalpha — valores bool em formato textual nos fluxos
std::boolalpha ativa a escrita e a leitura textuais de valores bool num fluxo específico. Com a locale clássica, os nomes usados são true e false. A definição mantém-se ativa até ser alterada.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
std::ios_base& std::boolalpha(std::ios_base& str);
out << std::boolalpha << value;
in >> std::boolalpha >> value;std::boolalpha é um manipulador de fluxo declarado em <ios>. Utilize out << std::boolalpha para configurar a saída ou in >> std::boolalpha para configurar a entrada. A função define a flag std::ios_base::boolalpha e devolve uma referência ao mesmo fluxo; não escreve nem lê qualquer valor por si só.
Com a flag ativa, os valores do tipo bool são escritos e reconhecidos através dos nomes da locale do fluxo. Para std::locale::classic(), estes são true e false. Não pressuponha que todas as locales utilizam os mesmos nomes. O manipulador não transforma números inteiros em palavras.
A definição aplica-se ao fluxo específico e mantém-se ativa para além da operação seguinte. std::noboolalpha limpa a flag, voltando a permitir a escrita e a leitura de valores bool em formato numérico sem alterar as restantes flags de formatação. Por exemplo, com a locale clássica e a flag std::ios_base::showpos ativa, true é escrito como +1 em formato decimal. Alterar o formato de std::cout não altera o formato de um fluxo de entrada separado.
Na entrada, o texto que não corresponde ao nome esperado faz com que failbit seja definido; verifique o resultado da operação, por exemplo com if (!(input >> std::boolalpha >> value)). O exemplo aplica a locale clássica a ambos os fluxos, lê dois valores e, em seguida, mostra a saída textual e a numérica.
Exemplos
#include <ios>
#include <iostream>
#include <locale>
#include <sstream>
int main() {
std::cout.imbue(std::locale::classic());
std::istringstream input("true false");
input.imbue(std::locale::classic());
bool first = false;
bool second = true;
if (!(input >> std::boolalpha >> first >> second)) {
return 1;
}
std::cout << std::boolalpha << first << ' ' << second << '\n';
std::cout << std::noboolalpha << first << ' ' << second << '\n';
}
Resultado
true false 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.