CKTIS / C++
Einfügeoperator für Ausgabeströme (`<<`)
Mit `<<` lassen sich Werte in einen Ausgabestrom schreiben oder dessen Formatierung ändern. Die Operandentypen unterscheiden die Ausgabe von einer Bitverschiebung.
Version: ISO C++23; implementation support may vary
Syntax
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);In C++23 schreibt std::cout << x in einen Ausgabestrom; 1u << 3 ist dagegen eine eingebaute bitweise Linksverschiebung. Das Operatorzeichen ist gleich, doch Operandentypen und Operation unterscheiden sich. Nach der C++-Grammatik ist << linksassoziativ: out << a << b wird unabhängig vom Rückgabetyp der gewählten Überladung als (out << a) << b gruppiert. Für einen lvalue out vom Typ std::ostream geben die üblichen Überladungen eine std::ostream& auf denselben Strom zurück, damit die nächste Ausgabe in denselben Strom schreibt. Leerzeichen und Zeilenumbrüche werden nicht automatisch eingefügt.
Zahlen verwenden Member-Überladungen, char und Text dagegen freie Überladungen. Verwende out << x statt out.operator<<(x), da der explizite Member-Aufruf freie Funktionen nicht berücksichtigt. Beim Einfügen eines const char* muss der Zeiger auf eine gültige nullterminierte Zeichenfolge zeigen. std::string und std::string_view verwenden ihre Länge; ein enthaltenes Nullzeichen beendet die Ausgabe nicht. std::string_view besitzt die Daten nicht: Die referenzierten Zeichen müssen während der gesamten Ausgabe gültig bleiben.
Die Formatierung ist eine Eigenschaft des Stroms. Sowohl out << std::boolalpha als auch out.setf(std::ios::boolalpha) aktivieren die von der Locale abhängigen Namen für bool (true und false in der klassischen Locale). Das Flag bleibt gesetzt, bis es etwa mit std::noboolalpha gelöscht wird. Dagegen legt std::setw(n) eine Mindestfeldbreite fest, die gewöhnliche Ausgabeüberladungen für Zeichen, Zeichenfolgen und Zahlen nach Gebrauch auf null zurücksetzen.
out << '\n' fügt einen Zeilenumbruch ein, ohne ausdrücklich das Leeren des Puffers anzufordern. std::endl fügt einen Zeilenumbruch ein und ruft flush() auf. Die Rückgabe des Stroms belegt keinen Erfolg: Prüfe danach if (!out). Bei einem Fehler können failbit oder badbit gesetzt werden; je nach Ausnahmemaske des Stroms kann eine Ausnahme ausgelöst werden.
Definiere für einen eigenen Typ T einen freien operator<<(std::ostream&, const T&) im Namensraum des Typs, nicht in std. Die argumentabhängige Namenssuche (ADL) kann ihn dort finden. Schreibe in den übergebenen Strom und gib ihn als Referenz zurück, damit sich Ausgaben verketten lassen.
Beispiele
#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';
}Ergebnis
AB: true false shift=8
`report::Result` gibt `AB` aus, weil die Ansicht nur die ersten beiden Zeichen von `ABC` erfasst. `boolalpha` gilt in der eigenen Überladung und beim anschließenden `false`. In der zweiten Zeile trennen die Klammern die Bitverschiebung, die `8` ergibt, von der Ausgabe des Ergebnisses.
Zugehörige Lektionen
- C++ · Lektion 1 · Fortgeschritten · Version: 3
- C++ · Lektion 2 · Fortgeschritten · Version: 3
- C++ · Lektion 3 · Fortgeschritten · Version: 3
- C++ · Lektion 4 · Fortgeschritten · Version: 3
- C++ · Lektion 5 · Fortgeschritten · Version: 3
- C++ · Lektion 6 · Fortgeschritten · Version: 3
- C++ · Lektion 7 · Fortgeschritten · Version: 3
- C++ · Lektion 8 · Fortgeschritten · Version: 3
- C++ · Lektion 9 · Fortgeschritten · Version: 3
- C++ · Lektion 10 · Fortgeschritten · Version: 3
- C++ · Lektion 11 · Fortgeschritten · Version: 3
- C++ · Lektion 12 · Fortgeschritten · Version: 3
- C++ · Lektion 13 · Fortgeschritten · Version: 3
- C++ · Lektion 14 · Fortgeschritten · Version: 3
- C++ · Lektion 15 · Fortgeschritten · Version: 3
- C++ · Lektion 16 · Fortgeschritten · Version: 3
- C++ · Lektion 17 · Fortgeschritten · Version: 3
- C++ · Lektion 18 · Fortgeschritten · Version: 3
- C++ · Lektion 19 · Fortgeschritten · Version: 3
- C++ · Lektion 20 · Fortgeschritten · Version: 3
- C++ · Lektion 21 · Fortgeschritten · Version: 3
- C++ · Lektion 22 · Fortgeschritten · Version: 3
- C++ · Lektion 23 · Fortgeschritten · Version: 3
- C++ · Lektion 24 · Fortgeschritten · Version: 3
- C++ · Lektion 25 · Fortgeschritten · Version: 3
- C++ · Lektion 26 · Fortgeschritten · Version: 3
- C++ · Lektion 27 · Fortgeschritten · Version: 3
- C++ · Lektion 28 · Fortgeschritten · Version: 3
- C++ · Lektion 29 · Fortgeschritten · Version: 3
- C++ · Lektion 30 · Fortgeschritten · Version: 3
- C++ · Lektion 31 · Fortgeschritten · Version: 3
- C++ · Lektion 32 · Fortgeschritten · Version: 3
- C++ · Lektion 33 · Fortgeschritten · Version: 3
- C++ · Lektion 34 · Fortgeschritten · Version: 3
- C++ · Lektion 35 · Fortgeschritten · Version: 3
- C++ · Lektion 36 · Fortgeschritten · Version: 3
- C++ · Lektion 37 · Fortgeschritten · Version: 3
- C++ · Lektion 38 · Fortgeschritten · Version: 3
- C++ · Lektion 39 · Fortgeschritten · Version: 3
- C++ · Lektion 40 · Fortgeschritten · Version: 3
- C++ · Lektion 41 · Fortgeschritten · Version: 3
- C++ · Lektion 42 · Fortgeschritten · Version: 3
- C++ · Lektion 43 · Fortgeschritten · Version: 3
- C++ · Lektion 44 · Fortgeschritten · Version: 3
- C++ · Lektion 45 · Fortgeschritten · Version: 3
- C++ · Lektion 46 · Fortgeschritten · Version: 3
- C++ · Lektion 47 · Fortgeschritten · Version: 3
- C++ · Lektion 48 · Fortgeschritten · Version: 3
- C++ · Lektion 49 · Fortgeschritten · Version: 3
- C++ · Lektion 50 · Fortgeschritten · Version: 3
- C++ · Lektion 51 · Fortgeschritten · Version: 3
- C++ · Lektion 52 · Fortgeschritten · Version: 3
- C++ · Lektion 53 · Fortgeschritten · Version: 3
- C++ · Lektion 54 · Fortgeschritten · Version: 3
- C++ · Lektion 55 · Fortgeschritten · Version: 3
- C++ · Lektion 56 · Fortgeschritten · Version: 3
- C++ · Lektion 57 · Fortgeschritten · Version: 3
- C++ · Lektion 58 · Fortgeschritten · Version: 3
- C++ · Lektion 59 · Fortgeschritten · Version: 3
- C++ · Lektion 60 · Fortgeschritten · Version: 3
Quellen
- 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]