CKTIS / C++
Opérateur d’insertion dans un flux <<
L’opérateur << écrit des valeurs dans un flux de sortie. Découvrez la différence entre les surcharges membres et les fonctions non membres, ainsi que la façon de prendre en charge un type personnalisé tout en conservant les insertions chaînées.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
stream << value;
stream << first << second;
std::ostream& operator<<(std::ostream& os, const T& value);L’expression stream << value sélectionne une surcharge d’insertion dans un flux de sortie. std::ostream est un alias de std::basic_ostream<char>. Le symbole std::ostream::operator<< désigne les surcharges membres, notamment celles destinées aux nombres et aux pointeurs de fonction de manipulateur. Ici, operator<<(std::ostream&, ...) désigne une famille de fonctions non membres, et non la déclaration d’une fonction variadique : ... est un espace réservé descriptif pour des paramètres supplémentaires. Les surcharges standard pour les caractères et les chaînes terminées par un caractère nul sont des fonctions non membres.
Les surcharges utilisées dans l’exemple renvoient une référence au même flux ; ainsi, stream << first << second fonctionne comme (stream << first) << second. L’insertion n’ajoute automatiquement ni espaces ni saut de ligne. L’appel explicite stream.operator<<('A') contourne les surcharges non membres pour les caractères et sélectionne une surcharge numérique au lieu d’afficher le caractère.
Pour un type personnalisé, définissez une fonction non membre std::ostream& operator<<(std::ostream& os, const T& value) dans le même espace de noms que le type, et non dans std. Renvoyez os, généralement en renvoyant l’expression d’insertion complète. L’exemple applique ce modèle à Point et ajoute explicitement \n.
La sortie dépend de l’état de formatage du flux ; les manipulateurs peuvent, par exemple, modifier le format des nombres. Renvoyer une référence ne confirme pas la réussite de l’écriture : vérifiez l’état du flux, comme dans l’exemple. Les sources fournies sont le brouillon actuel de la norme, et non un texte C++23 figé ; une compilation locale avec une option C++23 n’établit pas la compatibilité avec l’environnement d’exécution de production.
Exemples
#include <iostream>
struct Point {
int x;
int y;
};
std::ostream& operator<<(std::ostream& os, const Point& point) {
return os << '(' << point.x << ", " << point.y << ')';
}
int main() {
const Point point{2, 3};
std::cout << "Point: " << point << '\n';
return std::cout ? 0 : 1;
}
Résultat
Point: (2, 3)
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.