CKTIS / C++
std::setw — die Feldbreite eines Streams festlegen
std::setw(n) aus <iomanip> legt die Feldbreite eines Streams fest. Bei der Ausgabe werden kürzere Werte aufgefüllt und längere nicht abgeschnitten. Für aufeinanderfolgende Felder muss die Breite erneut gesetzt werden, da Ausgabeoperationen sie zurücksetzen können.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) ist ein in <iomanip> deklarierter Manipulator. Als out << std::setw(n) oder in >> std::setw(n) verwendet, ruft er für den jeweiligen Stream effektiv width(n) auf. Er nimmt ein int entgegen und gibt ein Objekt nicht näher festgelegten Typs zurück, nicht die Breite selbst. Bei der Eingabe hängt die Bedeutung der Einstellung von der Extraktionsoperation ab; sie ist keine allgemeine Begrenzung der Ziffernanzahl.
Bei der Ausgabe gibt die Breite für Operationen, die sie berücksichtigen, eine Mindestfeldgröße an. Eine kürzere Darstellung erhält Füllzeichen; eine längere wird vollständig ausgegeben. std::setfill legt das Füllzeichen fest, während std::left und std::right Text links beziehungsweise rechts ausrichten.
Behandle die Breite nicht als dauerhafte Spalteneinstellung. Einfügeoperationen für Zeichen und Zeichenketten setzen sie nach der Verwendung zurück. Setze daher std::setw(n) unmittelbar vor jedes Feld, das aufgefüllt werden soll. Auch ein vor dem vorgesehenen Wert eingefügtes Trennzeichen kann die Breite verbrauchen. Das bloße Festlegen des Füllzeichens oder der Ausrichtung verbraucht sie nicht; diese Einstellungen bleiben aktiv, bis sie geändert werden.
Im Beispiel erhält cat links zwei Punkte, x wird nicht aufgefüllt und dog erhält rechts zwei Punkte. bird bleibt trotz der Breite 2 vollständig. std::setw ist im Abschnitt [std.manip] definiert. Das zitierte Dokument ist ein Arbeitsentwurf, keine endgültige Veröffentlichung von C++23.
Beispiele
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
out << std::setfill('.') << std::right;
out << '|' << std::setw(5) << "cat" << '|' << "x" << '|';
out << std::left << std::setw(5) << "dog" << '|';
out << std::setw(2) << "bird" << '|';
std::cout << out.str() << '\n';
}
Ergebnis
|..cat|x|dog..|bird|
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.