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

CKTIS / C++

std::setw — establecer el ancho de campo de un flujo

std::setw(n), declarado en <iomanip>, establece el ancho de campo de un flujo. En la salida, los valores más cortos se rellenan y los más largos no se truncan. Vuelve a aplicar el ancho a cada campo sucesivo, porque las operaciones de salida pueden restablecerlo.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;

std::setw(n) es un manipulador declarado en <iomanip>. Cuando se usa como out << std::setw(n) o in >> std::setw(n), en la práctica llama a width(n) en el flujo correspondiente. Acepta un int y devuelve un objeto de tipo no especificado, no el ancho en sí. En la entrada, el significado del ajuste depende de la operación de extracción; no es un límite general para el número de dígitos.

En la salida, el ancho indica el tamaño mínimo del campo para las operaciones que lo tienen en cuenta. Una representación más corta recibe caracteres de relleno; una más larga se escribe completa. std::setfill elige el carácter de relleno, mientras que std::left y std::right permiten alinear el texto a la izquierda y a la derecha, respectivamente.

No trates el ancho como un ajuste permanente de columna. Las operaciones de inserción de caracteres y cadenas de caracteres lo restablecen después de usarlo, así que coloca std::setw(n) justo antes de cada campo que necesite relleno. Incluso un separador insertado antes del valor previsto puede consumir el ancho. Establecer el relleno o la alineación no lo consume; esos ajustes permanecen activos hasta que se cambian.

En el ejemplo, cat recibe dos puntos a la izquierda, x no se rellena y dog recibe dos puntos a la derecha. bird se mantiene completo a pesar del ancho 2. std::setw se define en la sección [std.manip]. El documento citado es un borrador de trabajo, no una publicación definitiva de C++23.

Ejemplos

#include <iomanip>
#include <iostream>
#include <sstream>

int main() {
    std::ostringstream out;
    out << std::setfill('.') << std::right;
    out << '|' << std::setw(5) << "cat" << '|' << "x" << '|';
    out << std::left << std::setw(5) << "dog" << '|';
    out << std::setw(2) << "bird" << '|';
    std::cout << out.str() << '\n';
}

Resultado

|..cat|x|dog..|bird|

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