CKTIS / C++
std::ios::boolalpha — valores booleanos en texto
Activa el indicador `std::ios::boolalpha` con `setf` para leer y escribir valores `bool` con los nombres de la configuración regional del flujo, en vez de usar números.
Versión: ISO C++23; implementation support may vary
Sintaxis
#include <iostream>
// Inside a function:
const auto previous = std::cout.setf(std::ios::boolalpha);
std::cout << true;
std::cout.flags(previous);std::ios::boolalpha es un indicador de formato de tipo std::ios_base::fmtflags, no una función. std::ios es un alias de std::basic_ios<char>. Tanto el indicador como la función miembro setf se declaran en std::ios_base y están disponibles por herencia.
std::cout.setf(std::ios::boolalpha) activa ese indicador sin cambiar los demás y devuelve el conjunto completo de indicadores anteriores. La sobrecarga setf(flags, mask) solo sustituye los bits seleccionados por la máscara. La llamada no imprime nada por sí sola: un << posterior inserta el valor bool. Con la configuración regional clásica, se obtiene true o false en lugar de los valores predeterminados 1 o 0. Los enteros, como el literal 1 de tipo int, se siguen imprimiendo como números.
El ajuste pertenece a ese flujo y sigue activo después de la siguiente inserción. Usa unsetf(std::ios::boolalpha) para desactivar solo ese indicador o flags(previous) para restaurar todos los indicadores guardados. La función libre std::boolalpha, usada como en std::cout << std::boolalpha, activa el mismo indicador. El ejemplo llama directamente a setf.
En un flujo de entrada, el mismo indicador hace que >> para bool busque los nombres que proporciona la faceta std::numpunct de la configuración regional de ese flujo. Si la lectura no encuentra una coincidencia única, activa failbit. Activar el indicador en std::cout no cambia std::cin.
Ejemplos
#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()` fija las grafías `true` y `false`. El programa imprime los valores antes de activar el indicador, después de activarlo y tras restaurar los indicadores anteriores.
Lecciones relacionadas
- C++ · Lección 5 · Avanzado · Versión: 3
Fuentes
- 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