WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::endl — Zeilenumbruch und Leeren des Stream-Puffers

std::endl fügt einen Zeilenumbruch ein und ruft flush() für einen Ausgabestream auf. Anders als '\n' fordert es ausdrücklich die Synchronisierung des Puffers an; verwenden Sie es, wenn Sie beide Vorgänge benötigen.

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

Syntax

os << std::endl;
// Equivalent calls:
os.put(os.widen('\n'));
os.flush();

std::endl ist ein Manipulator für Ausgabestreams, der in <ostream> deklariert ist. Die übliche Schreibweise ist os << std::endl, ohne Klammern hinter dem Namen des Manipulators. Es handelt sich um eine Funktionsvorlage, die verschiedene Zeichenarten von Streams unterstützt.

Es ruft zuerst os.put(os.widen('\n')) und anschließend os.flush() auf und gibt danach os zurück. widen passt das Zeichen an den Zeichentyp des Streams an. Die zurückgegebene Referenz ermöglicht es, weitere <<-Operationen aneinanderzureihen.

'\n' bezeichnet ein Zeilenumbruchzeichen; durch dessen Einfügen wird nicht ausdrücklich das Leeren des Puffers angefordert. std::flush fordert das Leeren an, ohne einen Zeilenumbruch hinzuzufügen. Wenn Sie nur einen Zeilenumbruch benötigen, wählen Sie '\n', damit nicht für jede Zeile eine zusätzliche Synchronisierung erzwungen wird.

flush() synchronisiert den Stream-Puffer; es garantiert nicht, dass Daten dauerhaft auf der Festplatte gespeichert werden. Ausgabeoperationen können fehlschlagen, einen Fehlerzustand setzen und — abhängig von der Ausnahmemaske — eine Ausnahme auslösen. Das Beispiel prüft den Zustand von std::cout, aber der sichtbare Text allein zeigt nicht, wann das Leeren stattgefunden hat.

Beispiele

#include <iostream>

int main() {
    std::cout << "Ready" << std::endl;
    std::cout << "Done\n";
    return std::cout ? 0 : 1;
}

Ergebnis

Ready
Done

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