CKTIS / C++
std::right — aligner un champ de sortie à droite
std::right active l’alignement à droite dans un flux de sortie : les caractères de remplissage précèdent la valeur. Ce réglage persiste ; la largeur du champ se définit séparément, par exemple avec std::setw.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ios>
std::ios_base& std::right(std::ios_base& str);
// Usage: out << std::right << std::setw(width) << value;std::right est un manipulateur déclaré dans <ios>, utilisé sous la forme out << std::right. Il appelle str.setf(std::ios_base::right, std::ios_base::adjustfield) et renvoie une référence au même flux. Il remplace le réglage précédent du groupe adjustfield, par exemple std::left ou std::internal, sans modifier les autres groupes de drapeaux.
Si la largeur du champ dépasse la longueur de la représentation affichée, des caractères de remplissage sont ajoutés avant celle-ci. std::right ne définit ni la largeur ni le caractère de remplissage : utilisez respectivement std::setw et std::setfill de <iomanip>. La largeur est un minimum, et non une limite qui tronque le texte.
L’alignement reste actif jusqu’à ce que les drapeaux soient modifiés à nouveau. En revanche, l’insertion d’un caractère ou d’une chaîne de caractères réinitialise la largeur du champ. Réutilisez donc std::setw avant chaque champ de ce type qui doit être complété. Ne confondez pas le réglage persistant de l’alignement avec la largeur d’un champ individuel.
L’exemple définit le point comme caractère de remplissage et écrit deux chaînes dans des champs de largeur 5. Les séparateurs | indiquent les limites des champs ; le résultat attendu est |..cat|...ox| suivi d’un saut de ligne.
Exemples
#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";
}
Résultat
|..cat|...ox|
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- 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]