CKTIS / C++
std::right — alinear un campo de salida a la derecha
std::right establece la alineación a la derecha en un flujo de salida: los caracteres de relleno aparecen antes del valor. El ajuste persiste, mientras que el ancho del campo se especifica por separado, por ejemplo con std::setw.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <ios>
std::ios_base& std::right(std::ios_base& str);
// Usage: out << std::right << std::setw(width) << value;std::right es un manipulador declarado en <ios> que se usa como out << std::right. Llama a str.setf(std::ios_base::right, std::ios_base::adjustfield) y devuelve una referencia al mismo flujo. Sustituye el ajuste anterior del grupo adjustfield, como std::left o std::internal, sin modificar los demás grupos de indicadores.
Si el ancho del campo supera la longitud de la representación de salida, se añaden caracteres de relleno delante de esta. std::right no establece por sí solo ni el ancho ni el carácter de relleno: use, respectivamente, std::setw y std::setfill de <iomanip>. El ancho es un mínimo, no un límite que trunque el texto.
La alineación permanece activa hasta que se cambien los indicadores. En cambio, insertar un carácter o una cadena de caracteres restablece el ancho del campo, así que vuelva a usar std::setw antes de cada campo de este tipo que necesite relleno. No confunda el ajuste persistente de alineación con el ancho de un campo individual.
El ejemplo establece el punto como carácter de relleno y escribe dos cadenas en campos de ancho 5. Los separadores | muestran los límites de los campos; el resultado esperado es |..cat|...ox| seguido de un salto de línea.
Ejemplos
#include <iomanip>
#include <ios>
#include <iostream>
int main() {
std::cout << std::setfill('.') << std::right;
std::cout << '|' << std::setw(5) << "cat"
<< '|' << std::setw(5) << "ox" << "|\n";
}
Resultado
|..cat|...ox|
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
- C++ working draft — adjustfield manipulators [adjustfield.manip]
- C++ working draft — Header <ios> synopsis [ios.syn]
- C++ working draft — Common requirements [ostream.formatted.reqmts]
- C++ working draft — Character inserter function templates [ostream.inserters.character]
- C++ working draft — Standard manipulators [std.manip]