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

CKTIS / C++

std::left — alinear un campo de salida a la izquierda

std::left selecciona la alineación a la izquierda para la salida formateada de un flujo. Cuando un campo es más ancho que su valor, los caracteres de relleno aparecen después del valor. La alineación permanece activa hasta que se cambia.

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

Sintaxis

#include <iomanip>
#include <ios>
#include <ostream>

// Usage with an output stream:
out << std::left << std::setw(width) << value;

std::left es un manipulador declarado en <ios>. Escribir out << std::left cambia el estado de formato del flujo en lugar de imprimir texto. La función llama a str.setf(std::ios_base::left, std::ios_base::adjustfield) y devuelve str: sustituye el ajuste de alineación sin cambiar otros grupos de indicadores.

En un campo de salida alineado a la izquierda, los caracteres de relleno van después del valor. Establece el ancho con std::setw(width) y el carácter de relleno con std::setfill(c); ambos manipuladores requieren <iomanip>. El ancho es un mínimo: el texto más largo no se trunca. std::left no establece por sí mismo ni el ancho ni el carácter de relleno.

La alineación y el carácter de relleno permanecen establecidos hasta que se cambian. En cambio, insertar un carácter o una cadena de caracteres restablece el ancho del campo, así que vuelve a usar std::setw antes de cada campo de ese tipo. std::right sustituye la alineación a la izquierda por la alineación a la derecha. Si usas un flujo compartido, recuerda que el estado modificado también afecta a las operaciones de salida posteriores.

El ejemplo usa puntos para que el relleno sea visible. Los dos primeros campos muestran que std::left permanece activo, y el último muestra el cambio a std::right. Puedes verificar el ejemplo localmente con -std=c++23. El código fuente mostrado se ejecutó sin cambios en un entorno aislado y la salida estándar (stdout) coincidió exactamente con la salida esperada. Esta verificación no acredita el comportamiento en tiempo de ejecución en producción.

Ejemplos

#include <iomanip>
#include <ios>
#include <iostream>

int main() {
    std::cout << std::setfill('.') << std::left;
    std::cout << '|' << std::setw(6) << "cat"
              << '|' << std::setw(6) << "ox" << "|\n";
    std::cout << std::right
              << '|' << std::setw(6) << "cat" << "|\n";
}

Resultado

|cat...|ox....|
|...cat|

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