WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::setfill — Füllzeichen für Ausgabefelder

std::setfill aus <iomanip> legt das Zeichen fest, mit dem Felder bei der formatierten Ausgabe aufgefüllt werden. Es wirkt zusammen mit einer Feldbreite, etwa einer mit std::setw festgelegten, und bleibt aktiv, bis es geändert wird.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <iomanip>
// Declaration (unspecified denotes an unspecified return type):
template<class charT> unspecified setfill(charT c);
// Usage:
out << std::setfill(c);

std::setfill(c) ist ein Manipulator aus <iomanip>. Der Ausdruck out << std::setfill(c) ändert den Zustand des Streams so, als würde out.fill(c) aufgerufen; er gibt selbst keine Zeichen aus. Die Funktion liefert ein Objekt mit nicht spezifiziertem Typ zurück. Der vollständige Ausdruck mit << liefert eine Referenz auf out, sodass sich Operationen verketten lassen.

Wenn die formatierte Ausgabe aufgefüllt werden muss, um eine Feldbreite zu erreichen, verwendet der Stream das festgelegte Zeichen. std::setw(n) legt eine Mindestbreite fest, keine Längenbegrenzung: Längerer Text wird nicht abgeschnitten. Bei Text setzt std::right die Füllzeichen vor den Inhalt und std::left danach. std::setfill allein legt weder Breite noch Ausrichtung fest.

Das Füllzeichen bleibt für nachfolgende Operationen eingestellt, während das Einfügen von Zeichen und Zeichenketten die Feldbreite auf null zurücksetzt. Verwende daher vor jedem Feld, das aufgefüllt werden soll, erneut std::setw. Wenn ein Stream gemeinsam genutzt wird, sichere das vorherige Zeichen mit out.fill() und stelle es mit out.fill(previous) wieder her; andere Formatierungseinstellungen werden dadurch nicht wiederhergestellt.

Der Typ von c muss zum Zeichentyp des Streams passen: Verwende zum Beispiel '.' für einen char-Stream und L'.' für einen wchar_t-Stream. Das Beispiel zeigt, dass das Füllzeichen bestehen bleibt, sowie beide Ausrichtungsrichtungen. Die Spezifikation von std::setfill steht im Abschnitt [std.manip] des C++-Normentwurfs.

Beispiele

#include <iomanip>
#include <iostream>
#include <sstream>

int main() {
    std::ostringstream out;
    const char previous = out.fill();

    out << std::setfill('.') << std::right
        << std::setw(5) << "A" << '|'
        << std::setw(5) << "BC" << '|'
        << std::left << std::setw(5) << "D";

    out.fill(previous);
    std::cout << out.str() << '\n';
}

Ergebnis

....A|...BC|D....

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