CKTIS / C++
std::left — ein Ausgabefeld linksbündig ausrichten
std::left wählt die Linksausrichtung für formatierte Stream-Ausgaben. Ist ein Feld breiter als sein Wert, erscheinen Füllzeichen nach dem Wert. Die Ausrichtung bleibt aktiv, bis sie geändert wird.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iomanip>
#include <ios>
#include <ostream>
// Usage with an output stream:
out << std::left << std::setw(width) << value;std::left ist ein in <ios> deklarierter Manipulator. out << std::left ändert den Formatierungszustand des Streams, statt Text auszugeben. Die Funktion ruft str.setf(std::ios_base::left, std::ios_base::adjustfield) auf und gibt str zurück: Sie ersetzt die Ausrichtungseinstellung, ohne andere Flag-Gruppen zu ändern.
In einem linksbündigen Ausgabefeld folgen die Füllzeichen auf den Wert. Legen Sie die Breite mit std::setw(width) und das Füllzeichen mit std::setfill(c) fest; beide Manipulatoren benötigen <iomanip>. Die Breite ist ein Mindestwert: Längerer Text wird nicht abgeschnitten. std::left selbst legt weder die Breite noch das Füllzeichen fest.
Die Ausrichtung und das Füllzeichen bleiben eingestellt, bis sie 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 erneut std::setw. std::right ersetzt die Linksausrichtung durch Rechtsausrichtung. Beachten Sie bei einem gemeinsam genutzten Stream, dass die geänderte Einstellung auch spätere Ausgabeoperationen beeinflusst.
Das Beispiel verwendet Punkte, damit die Auffüllung sichtbar ist. Die ersten beiden Felder zeigen, dass std::left aktiv bleibt; das letzte zeigt den Wechsel zu std::right. Sie können das Beispiel lokal mit -std=c++23 überprüfen. Der gezeigte Quellcode wurde unverändert in einer isolierten Umgebung ausgeführt, und die Standardausgabe (stdout) stimmte exakt mit der erwarteten Ausgabe überein. Diese Überprüfung bestätigt kein Laufzeitverhalten in einer Produktionsumgebung.
Beispiele
#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";
}
Ergebnis
|cat...|ox....| |...cat|
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]