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

CKTIS / C++

std::basic_ostream::flush — synchroniser le tampon de sortie

std::basic_ostream::flush demande la synchronisation du tampon d’un flux et renvoie une référence vers ce même flux. La fonction n’ajoute pas de saut de ligne ; un échec de synchronisation est signalé par badbit.

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

Syntaxe

basic_ostream& flush();
// Usage:
os.flush();

std::basic_ostream::flush est une fonction de sortie non formatée, appelée sous la forme os.flush(). Elle renvoie *this, ce qui permet d’enchaîner les opérations. Elle n’ajoute elle-même aucun caractère.

Si rdbuf() n’est pas un pointeur nul, un objet sentry est créé. Lorsque celui-ci autorise l’opération, rdbuf()->pubsync() est appelé. Un résultat de -1 déclenche setstate(badbit), ce qui peut lancer std::ios_base::failure selon le masque d’exceptions. Si sentry n’autorise pas l’opération, la synchronisation est ignorée.

os << std::flush appelle la même fonction membre. std::endl insère en plus un saut de ligne avant de l’appeler. La synchronisation dépend du type de tampon : elle ne doit pas être confondue avec une garantie de stockage durable sur un support physique.

L’exemple utilise un tampon personnalisé dont sync() compte les appels et signale une réussite. Même en l’absence de caractères enregistrés, out.flush() déclenche la synchronisation ; la sortie attendue est 1 suivi d’un saut de ligne.

Exemples

#include <iostream>
#include <ostream>
#include <streambuf>

class CountingBuffer : public std::streambuf {
public:
    int sync_calls = 0;

protected:
    int sync() override {
        ++sync_calls;
        return 0;
    }
};

int main() {
    CountingBuffer buffer;
    std::ostream out(&buffer);
    out.flush();
    std::cout << buffer.sync_calls << '\n';
}

Résultat

1

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