CKTIS / C++
std::right — ein Ausgabefeld rechtsbündig ausrichten
std::right aktiviert die Rechtsbündigkeit in einem Ausgabestream: Füllzeichen stehen vor dem Wert. Die Einstellung bleibt bestehen; die Feldbreite wird separat festgelegt, zum Beispiel mit std::setw.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <ios>
std::ios_base& std::right(std::ios_base& str);
// Usage: out << std::right << std::setw(width) << value;std::right ist ein in <ios> deklarierter Manipulator, der mit out << std::right verwendet wird. Er ruft str.setf(std::ios_base::right, std::ios_base::adjustfield) auf und gibt eine Referenz auf denselben Stream zurück. Er ersetzt die vorherige Einstellung der Gruppe adjustfield, etwa std::left oder std::internal, ohne andere Flag-Gruppen zu ändern.
Ist die Feldbreite größer als die Länge der ausgegebenen Darstellung, werden Füllzeichen davor eingefügt. std::right legt weder die Breite noch das Füllzeichen selbst fest: Verwenden Sie dafür jeweils std::setw und std::setfill aus <iomanip>. Die Breite ist ein Mindestwert und keine Grenze, an der Text abgeschnitten wird.
Die Ausrichtung bleibt eingestellt, bis die Flags erneut geändert werden. Im Gegensatz dazu setzt das Einfügen eines Zeichens oder einer Zeichenkette die Feldbreite zurück. Verwenden Sie daher vor jedem solchen Feld, das aufgefüllt werden soll, erneut std::setw. Verwechseln Sie die dauerhaft geltende Ausrichtung nicht mit der Breite eines einzelnen Feldes.
Das Beispiel legt den Punkt als Füllzeichen fest und gibt zwei Zeichenketten in Feldern der Breite 5 aus. Die Trennzeichen | markieren die Feldgrenzen; das erwartete Ergebnis ist |..cat|...ox| gefolgt von einem Zeilenumbruch.
Beispiele
#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";
}
Ergebnis
|..cat|...ox|
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- 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]