Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes