KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::endl — nieuwe regel en de streambuffer leegmaken

std::endl voegt een nieuwe regel in en roept flush() aan op een uitvoerstream. Anders dan '\n' vraagt het expliciet om synchronisatie van de buffer; gebruik het wanneer je beide bewerkingen nodig hebt.

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

Syntax

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

std::endl is een manipulator voor uitvoerstreams die in <ostream> is gedeclareerd. De gebruikelijke vorm is os << std::endl, zonder haakjes na de naam van de manipulator. Het is een functie-template die verschillende tekentypen van streams ondersteunt.

Het roept eerst os.put(os.widen('\n')) en daarna os.flush() aan, en retourneert vervolgens os. widen past het teken aan het tekentype van de stream aan. Dankzij de geretourneerde referentie kunnen verdere <<-bewerkingen aan elkaar worden gekoppeld.

'\n' staat voor een teken voor een nieuwe regel; door dit teken in te voegen wordt niet expliciet om het leegmaken van de buffer gevraagd. std::flush vraagt om het leegmaken zonder een nieuwe regel toe te voegen. Als je alleen een regeleinde nodig hebt, kies dan '\n' om te voorkomen dat voor elke regel extra synchronisatie wordt afgedwongen.

flush() synchroniseert de streambuffer; het garandeert niet dat gegevens permanent op schijf worden opgeslagen. Uitvoerbewerkingen kunnen mislukken, een foutstatus instellen en — afhankelijk van het uitzonderingsmasker — een uitzondering veroorzaken. Het voorbeeld controleert de status van std::cout, maar aan de zichtbare tekst alleen is niet te zien wanneer het leegmaken plaatsvond.

Voorbeelden

#include <iostream>

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

Resultaat

Ready
Done

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