WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

Stream-Einfügeoperator <<

Der Operator << schreibt Werte in einen Ausgabestream. Erfahre den Unterschied zwischen Member-Überladungen und freien Funktionen und wie du einen eigenen Typ unterstützt, ohne die Verkettung zu unterbrechen.

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

Syntax

stream << value;
stream << first << second;
std::ostream& operator<<(std::ostream& os, const T& value);

Der Ausdruck stream << value wählt eine Überladung für das Einfügen in einen Ausgabestream. std::ostream ist ein Alias für std::basic_ostream<char>. Das Symbol std::ostream::operator<< bezeichnet Member-Überladungen, darunter solche für Zahlen und Funktionszeiger auf Manipulatoren. operator<<(std::ostream&, ...) bezeichnet hier eine Familie freier Funktionen, keine Deklaration einer variadischen Funktion: ... ist ein beschreibender Platzhalter für weitere Parameter. Die Standardüberladungen für Zeichen und nullterminierte Zeichenketten sind freie Funktionen.

Die im Beispiel verwendeten Überladungen geben eine Referenz auf denselben Stream zurück. Deshalb funktioniert stream << first << second wie (stream << first) << second. Beim Einfügen werden nicht automatisch Leerzeichen oder ein Zeilenumbruch ergänzt. Der explizite Aufruf stream.operator<<('A') umgeht die freien Zeichenüberladungen und wählt statt der Ausgabe des Zeichens eine numerische Überladung.

Definiere für einen eigenen Typ eine freie Funktion std::ostream& operator<<(std::ostream& os, const T& value) im selben Namensraum wie der Typ, nicht in std. Gib os zurück, üblicherweise indem du den vollständigen Einfügeausdruck zurückgibst. Das Beispiel verwendet dieses Muster für Point und fügt ausdrücklich \n an.

Die Ausgabe hängt vom Formatierungszustand des Streams ab; Manipulatoren können beispielsweise die Zahlenformatierung ändern. Eine zurückgegebene Referenz bestätigt nicht, dass die Ausgabe erfolgreich war: Prüfe den Streamzustand, wie im Beispiel. Die bereitgestellten Quellen sind der aktuelle Standardentwurf und kein festgeschriebener C++23-Text; ein lokaler Build mit einem C++23-Flag belegt keine Kompatibilität mit der Produktionslaufzeit.

Beispiele

#include <iostream>

struct Point {
    int x;
    int y;
};

std::ostream& operator<<(std::ostream& os, const Point& point) {
    return os << '(' << point.x << ", " << point.y << ')';
}

int main() {
    const Point point{2, 3};
    std::cout << "Point: " << point << '\n';
    return std::cout ? 0 : 1;
}

Ergebnis

Point: (2, 3)

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