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

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.

Fontes