WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::println — formatierte Ausgabe mit Zeilenumbruch

std::println aus <print> formatiert Argumente, gibt das Ergebnis aus und hängt einen Zeilenumbruch an. Standardmäßig wird stdout verwendet; mit einer Überladung, die FILE* entgegennimmt, lässt sich ein anderer Ausgabestream auswählen.

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

Syntax

#include <print>
std::println("format", args...);
std::println(stream, "format", args...);

std::println ist eine C++23-Standardbibliotheksfunktion, die in <print> deklariert ist. Der Aufruf std::println("format", args...) gibt formatierten Text auf stdout aus und hängt \n an. Die Funktion gibt void zurück. Anders als std::print beendet sie den Text automatisch mit einem Zeilenumbruch; das bedeutet jedoch nicht, dass der Puffer bei jedem Aufruf garantiert geleert wird.

Die Felder {} übernehmen aufeinanderfolgende Argumente. Auf einen Doppelpunkt kann eine Formatspezifikation folgen: {:04d} verlangt eine Dezimalzahl in einem mindestens vier Zeichen breiten Feld, das mit Nullen aufgefüllt wird. Im Beispiel wird 42 zu 0042; eine größere Zahl wird nicht abgeschnitten.

Die Form std::println(stream, "format", args...) erwartet als erstes Argument einen gültigen FILE*, der auf einen Ausgabestream zeigt. Schreibfehler können std::system_error auslösen; auch Formatierung und Speicherreservierung können Ausnahmen auslösen.

Erforderlich sind ein Compiler und eine Standardbibliothek, die <print> unterstützen; ein C++23-Compiler-Flag allein belegt die Verfügbarkeit nicht. Version des Eintrags: C++23; Compiler-Flag im Repository, Produktionslaufzeit nicht bestätigt. Die angegebenen Quellen beschreiben den sich weiterentwickelnden Standardentwurf, der Ergänzungen enthalten kann, die später als C++23 hinzugekommen sind.

Beispiele

#include <print>

int main() {
    std::println("{}: {:04d}", "Score", 42);
}

Ergebnis

Score: 0042

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