Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::endl — nouvelle ligne et vidage du tampon du flux

std::endl insère une nouvelle ligne et appelle flush() sur un flux de sortie. Contrairement à '\n', il demande explicitement la synchronisation du tampon ; utilisez-le lorsque vous avez besoin des deux opérations.

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

Syntaxe

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

std::endl est un manipulateur de flux de sortie déclaré dans <ostream>. Sa forme habituelle est os << std::endl, sans parenthèses après le nom du manipulateur. C'est un modèle de fonction qui prend en charge différents types de caractères de flux.

Il appelle os.put(os.widen('\n')), puis os.flush(), et renvoie ensuite os. widen adapte le caractère au type de caractères du flux. La référence renvoyée permet d'enchaîner d'autres opérations <<.

'\n' désigne un caractère de nouvelle ligne ; son insertion ne demande pas explicitement, à elle seule, le vidage du tampon. std::flush demande le vidage sans ajouter de nouvelle ligne. Si vous avez seulement besoin d'un saut de ligne, choisissez '\n' afin d'éviter de forcer une synchronisation supplémentaire à chaque ligne.

flush() synchronise le tampon du flux ; cela ne garantit pas un stockage durable des données sur le disque. Les opérations de sortie peuvent échouer, définir un état d'erreur et — selon le masque d'exceptions — lancer une exception. L'exemple vérifie l'état de std::cout, mais le texte visible ne permet pas, à lui seul, de savoir quand le vidage a eu lieu.

Exemples

#include <iostream>

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

Résultat

Ready
Done

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources