CKTIS / C++
std::setfill — carácter de relleno de campos de salida
std::setfill de <iomanip> establece el carácter que se usa para rellenar campos durante la salida formateada. Funciona junto con un ancho de campo, por ejemplo, el establecido por std::setw, y permanece activo hasta que se cambia.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <iomanip>
// Declaration (unspecified denotes an unspecified return type):
template<class charT> unspecified setfill(charT c);
// Usage:
out << std::setfill(c);std::setfill(c) es un manipulador de <iomanip>. La expresión out << std::setfill(c) cambia el estado del flujo como si se llamara a out.fill(c); no escribe caracteres por sí misma. La función devuelve un objeto de tipo no especificado, mientras que la expresión completa con << devuelve una referencia a out, lo que permite encadenar operaciones.
Cuando la salida formateada necesita relleno para alcanzar el ancho del campo, el flujo utiliza el carácter configurado. std::setw(n) especifica un ancho mínimo, no un límite de longitud: el texto más largo no se trunca. Para texto, std::right coloca el relleno antes del contenido y std::left lo coloca después. std::setfill por sí solo no establece ni el ancho ni la alineación.
El carácter de relleno permanece configurado para las operaciones siguientes, mientras que insertar caracteres y cadenas restablece a cero el ancho del campo. Por tanto, repite std::setw antes de cada campo que necesite relleno. Si se comparte un flujo, guarda el carácter anterior con out.fill() y restáuralo con out.fill(previous); esto no restaura otros ajustes de formato.
El tipo de c debe coincidir con el tipo de carácter del flujo: usa, por ejemplo, '.' para un flujo char y L'.' para uno wchar_t. El ejemplo muestra la persistencia del carácter de relleno y los dos sentidos de alineación. La especificación de std::setfill se encuentra en la sección [std.manip] del borrador del estándar de C++.
Ejemplos
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
const char previous = out.fill();
out << std::setfill('.') << std::right
<< std::setw(5) << "A" << '|'
<< std::setw(5) << "BC" << '|'
<< std::left << std::setw(5) << "D";
out.fill(previous);
std::cout << out.str() << '\n';
}
Resultado
....A|...BC|D....
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.