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

CKTIS / C++

std::ostream et std::basic_ostream — flux de sortie

std::basic_ostream est un modèle de flux de sortie, et std::ostream en est l’alias pour char. Ils permettent de formater des valeurs avec operator<< et d’écrire des caractères dans un tampon de flux associé.

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

Syntaxe

#include <ostream>
std::basic_ostream<CharT, Traits>
std::ostream // std::basic_ostream<char, std::char_traits<char>>
std::ostream& write_value(std::ostream& out, int value);

std::basic_ostream<CharT, Traits> de <ostream> fournit une interface pour écrire dans un tampon de flux. CharT détermine le type de caractère, tandis que Traits fournit les opérations sur les caractères ; sa valeur par défaut est std::char_traits<CharT>. std::ostream est exactement un alias de std::basic_ostream<char>, et non un modèle distinct ni un objet de sortie.

operator<< formate des valeurs, par exemple des nombres. Les opérations d’insertion renvoient une référence au flux, ce qui permet d’enchaîner les appels. put(c) écrit un caractère, tandis que write(s, n) écrit n caractères sans formatage, sauf en cas d’échec de la sortie. flush() demande la synchronisation du tampon associé ; cela ne garantit pas une écriture durable sur le disque.

Acceptez un std::ostream& afin qu’une fonction puisse utiliser le flux fourni sans le copier. Dans l’exemple, write_value reçoit std::cout et renvoie le même flux, après quoi put('\n') ajoute un caractère de nouvelle ligne. Un simple \n ne demande pas de vider le tampon ; l’exemple appelle explicitement flush().

Les erreurs de sortie sont signalées par l’état du flux, notamment failbit ou badbit ; le masque d’exceptions peut provoquer le déclenchement d’une exception. Ne supposez pas que l’absence d’exception signifie que tout a réussi : vérifiez l’état, comme le fait la condition finale de l’exemple. Cette entrée concerne C++23 ; la norme de compilation indiquée ne garantit pas un environnement d’exécution de production. Les sources présentent un projet de norme en évolution.

Exemples

#include <iostream>
#include <locale>
#include <ostream>

std::ostream& write_value(std::ostream& out, int value) {
    return out << "value=" << value;
}

int main() {
    std::cout.imbue(std::locale::classic());
    write_value(std::cout, 42).put('\n');
    std::cout.flush();
    return std::cout ? 0 : 1;
}

Résultat

value=42

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