CKTIS / C++
Opérateur d’insertion dans un flux de sortie (`<<`)
`<<` écrit des valeurs dans un flux de sortie ou modifie son formatage. Les types des opérandes distinguent l’insertion du décalage de bits vers la gauche.
Version : ISO C++23; implementation support may vary
Syntaxe
out << value;
out << first << second; // (out << first) << second
out << std::boolalpha << flag;
out << (1u << 3); // insert the result of a built-in left shift
// Conventional non-member overload in the namespace of T:
std::ostream& operator<<(std::ostream& out, const T& value);En C++23, std::cout << x insère une valeur dans un flux de sortie, tandis que 1u << 3 est un décalage de bits intégré vers la gauche. Le symbole est le même, mais les types des opérandes et les opérations diffèrent. Dans la grammaire du C++, << est associatif à gauche : out << a << b se groupe comme (out << a) << b, quel que soit le type de retour de la surcharge choisie. Pour une lvalue out de type std::ostream, les surcharges usuelles renvoient une référence std::ostream& vers le même flux, ce qui permet à l’insertion suivante d’y écrire. Aucun espace ni saut de ligne n’est ajouté automatiquement.
Les nombres utilisent des surcharges membres ; char et le texte utilisent des surcharges non membres. Préférez out << x à out.operator<<(x) : l’appel explicite du membre ignore les fonctions non membres. L’insertion d’un const char* exige un pointeur vers une chaîne valide terminée par un caractère nul. std::string et std::string_view utilisent leur longueur : un caractère nul interne n’arrête pas la sortie. Un std::string_view ne possède pas ses données : les caractères référencés doivent rester valides pendant toute l’insertion.
Le formatage est propre au flux. out << std::boolalpha et out.setf(std::ios::boolalpha) activent tous deux les noms des booléens selon les paramètres régionaux (true et false dans la locale classique). L’indicateur reste actif jusqu’à sa désactivation, par exemple avec std::noboolalpha. À l’inverse, std::setw(n) fixe une largeur minimale que les surcharges usuelles pour les caractères, les chaînes et les nombres remettent à zéro après utilisation.
out << '\n' insère un saut de ligne sans demander explicitement le vidage du tampon. std::endl insère un saut de ligne et appelle flush(). Le fait de récupérer le flux ne prouve pas que l’écriture a réussi : testez ensuite if (!out). Un échec peut positionner failbit ou badbit et, selon le masque d’exceptions du flux, déclencher une exception.
Pour un type T que vous définissez, placez un operator<<(std::ostream&, const T&) non membre dans l’espace de noms du type, et non dans std. La recherche dépendante des arguments (ADL) peut l’y trouver. Écrivez dans le flux reçu et renvoyez-le par référence pour permettre le chaînage.
Exemples
#include <ios>
#include <iostream>
#include <locale>
#include <ostream>
#include <string_view>
namespace report {
struct Result {
std::string_view label;
bool ok;
};
std::ostream& operator<<(std::ostream& out, const Result& result) {
return out << result.label << ": " << result.ok;
}
} // namespace report
int main() {
std::cout.imbue(std::locale::classic());
std::cout.setf(std::ios::boolalpha);
const report::Result result{std::string_view{"ABC", 2}, true};
std::cout << result << ' ' << false << '\n';
std::cout << "shift=" << (1u << 3) << '\n';
}Résultat
AB: true false shift=8
`report::Result` affiche `AB` car la vue ne couvre que les deux premiers caractères de `ABC`. L’indicateur `boolalpha` s’applique dans la surcharge personnalisée et au `false` qui suit. Sur la deuxième ligne, les parenthèses séparent le décalage qui donne `8` de l’insertion de ce résultat.
Leçons associées
- C++ · Leçon 1 · Avancé · Version : 3
- C++ · Leçon 2 · Avancé · Version : 3
- C++ · Leçon 3 · Avancé · Version : 3
- C++ · Leçon 4 · Avancé · Version : 3
- C++ · Leçon 5 · Avancé · Version : 3
- C++ · Leçon 6 · Avancé · Version : 3
- C++ · Leçon 7 · Avancé · Version : 3
- C++ · Leçon 8 · Avancé · Version : 3
- C++ · Leçon 9 · Avancé · Version : 3
- C++ · Leçon 10 · Avancé · Version : 3
- C++ · Leçon 11 · Avancé · Version : 3
- C++ · Leçon 12 · Avancé · Version : 3
- C++ · Leçon 13 · Avancé · Version : 3
- C++ · Leçon 14 · Avancé · Version : 3
- C++ · Leçon 15 · Avancé · Version : 3
- C++ · Leçon 16 · Avancé · Version : 3
- C++ · Leçon 17 · Avancé · Version : 3
- C++ · Leçon 18 · Avancé · Version : 3
- C++ · Leçon 19 · Avancé · Version : 3
- C++ · Leçon 20 · Avancé · Version : 3
- C++ · Leçon 21 · Avancé · Version : 3
- C++ · Leçon 22 · Avancé · Version : 3
- C++ · Leçon 23 · Avancé · Version : 3
- C++ · Leçon 24 · Avancé · Version : 3
- C++ · Leçon 25 · Avancé · Version : 3
- C++ · Leçon 26 · Avancé · Version : 3
- C++ · Leçon 27 · Avancé · Version : 3
- C++ · Leçon 28 · Avancé · Version : 3
- C++ · Leçon 29 · Avancé · Version : 3
- C++ · Leçon 30 · Avancé · Version : 3
- C++ · Leçon 31 · Avancé · Version : 3
- C++ · Leçon 32 · Avancé · Version : 3
- C++ · Leçon 33 · Avancé · Version : 3
- C++ · Leçon 34 · Avancé · Version : 3
- C++ · Leçon 35 · Avancé · Version : 3
- C++ · Leçon 36 · Avancé · Version : 3
- C++ · Leçon 37 · Avancé · Version : 3
- C++ · Leçon 38 · Avancé · Version : 3
- C++ · Leçon 39 · Avancé · Version : 3
- C++ · Leçon 40 · Avancé · Version : 3
- C++ · Leçon 41 · Avancé · Version : 3
- C++ · Leçon 42 · Avancé · Version : 3
- C++ · Leçon 43 · Avancé · Version : 3
- C++ · Leçon 44 · Avancé · Version : 3
- C++ · Leçon 45 · Avancé · Version : 3
- C++ · Leçon 46 · Avancé · Version : 3
- C++ · Leçon 47 · Avancé · Version : 3
- C++ · Leçon 48 · Avancé · Version : 3
- C++ · Leçon 49 · Avancé · Version : 3
- C++ · Leçon 50 · Avancé · Version : 3
- C++ · Leçon 51 · Avancé · Version : 3
- C++ · Leçon 52 · Avancé · Version : 3
- C++ · Leçon 53 · Avancé · Version : 3
- C++ · Leçon 54 · Avancé · Version : 3
- C++ · Leçon 55 · Avancé · Version : 3
- C++ · Leçon 56 · Avancé · Version : 3
- C++ · Leçon 57 · Avancé · Version : 3
- C++ · Leçon 58 · Avancé · Version : 3
- C++ · Leçon 59 · Avancé · Version : 3
- C++ · Leçon 60 · Avancé · Version : 3
Sources
- WG21 N4950 — C++23 working draft
- Formatted output functions [ostream.formatted]
- Shift operators [expr.shift]
- Operators in expressions [over.match.oper]
- Argument-dependent name lookup [basic.lookup.argdep]
- String view inserters and extractors [string.view.io]
- String inserters and extractors [string.io]
- fmtflags manipulators [fmtflags.manip]
- Standard manipulators [std.manip]
- Standard basic_ostream manipulators [ostream.manip]
- basic_ios member functions [basic.ios.members]