CKTIS / C++
`std::basic_ios::setf`: configurar los indicadores de formato de un flujo
`setf` cambia los indicadores de formato de un flujo. Con `std::ios::boolalpha` y la configuración regional clásica, los valores `bool` se imprimen como `true` y `false`.
Versión: ISO C++23; implementation support may vary
Sintaxis
// 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 es una función miembro heredada: las dos sobrecargas se declaran en std::ios_base. std::ios es un alias de std::basic_ios<char>, por lo que std::ios::boolalpha designa el mismo indicador heredado que std::ios_base::boolalpha.
setf(flags) activa los bits indicados y deja intactos los demás. setf(flags, mask) sustituye solo los bits seleccionados por mask por los bits correspondientes de flags. Usa, por ejemplo, out.setf(std::ios_base::hex, std::ios_base::basefield) para cambiar la base de los enteros sin dejar activo el indicador de la base anterior. Ambas sobrecargas devuelven el conjunto completo de indicadores anteriores como std::ios_base::fmtflags, no un código de error ni una referencia al flujo.
std::cout.setf(std::ios::boolalpha) no imprime nada. El operador de inserción en el flujo << usa el indicador al escribir después un valor bool. Con la configuración regional clásica se obtiene true o false en lugar de los habituales 1 o 0; otra configuración regional puede usar nombres distintos. std::cout << std::boolalpha activa el mismo indicador mediante un manipulador que es una función no miembro; el ejemplo no lo usa. El indicador no cambia cómo se imprimen los enteros 1 y 0.
El indicador sigue activo en ese flujo después de <<. Usa out.unsetf(std::ios::boolalpha) para desactivar solo ese indicador, o out.flags(previous) para restaurar todo el conjunto guardado.
Ejemplos
#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
El programa selecciona explícitamente `std::locale::classic()`. Las líneas esperadas son `1 0`, luego `true false` y, tras restaurar los indicadores, de nuevo `1 0`.
Lecciones relacionadas
- C++ · Lección 5 · Avanzado · Versión: 3
Fuentes
- 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]