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
- C++ working draft — ios_base state functions [fmtflags.state]
- C++ working draft — Class template basic_ios overview [ios.overview]
- C++ working draft — Header <iosfwd> synopsis [iosfwd.syn]
- C++ working draft — fmtflags manipulators [fmtflags.manip]
- C++ working draft — Arithmetic inserters [ostream.inserters.arithmetic]
- C++ working draft — num_put virtual functions [facet.num.put.virtuals]
- C++ working draft — Class template numpunct [locale.numpunct]