KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::println — geformatteerde uitvoer met een nieuwe regel

std::println uit <print> formatteert argumenten, schrijft het resultaat en voegt een nieuwe regel toe. Standaard gebruikt de functie stdout; met een overload die FILE* accepteert, kun je een andere uitvoerstroom kiezen.

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

Syntax

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

std::println is een C++23-functie uit de standaardbibliotheek, gedeclareerd in <print>. De aanroep std::println("format", args...) schrijft geformatteerde tekst naar stdout en voegt \n toe. De functie retourneert void. Anders dan std::print beëindigt zij de tekst automatisch met een nieuwe regel; dit garandeert echter niet dat de buffer bij elke aanroep wordt geleegd.

De velden {} gebruiken achtereenvolgens de argumenten. Na een dubbele punt kan een formaatspecificatie volgen: {:04d} vraagt om een decimaal geheel getal in een veld van minstens vier tekens, aangevuld met nullen. In het voorbeeld wordt 42 0042; een groter getal wordt niet afgekapt.

De vorm std::println(stream, "format", args...) neemt als eerste argument een geldige FILE* die naar een uitvoerstroom verwijst. Schrijffouten kunnen std::system_error veroorzaken; ook formatteren en geheugentoewijzing kunnen uitzonderingen veroorzaken.

Een compiler en standaardbibliotheek met ondersteuning voor <print> zijn vereist; alleen een C++23-vlag bewijst niet dat de functie beschikbaar is. Versie van het item: C++23; compiler-vlag in de repository, productie-runtime niet bevestigd. De opgegeven bronnen beschrijven het zich ontwikkelende standaardontwerp, dat aanvullingen kan bevatten die later dan C++23 zijn toegevoegd.

Voorbeelden

#include <print>

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

Resultaat

Score: 0042

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen