CKTIS / C++
Invoegoperator voor uitvoerstromen (`<<`)
Met `<<` schrijf je waarden naar een uitvoerstroom of pas je de opmaak ervan aan. De operandtypen maken het verschil tussen stroominvoeging en een bitverschuiving.
Versie: 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 voegt std::cout << x een waarde in een uitvoerstroom in, terwijl 1u << 3 een ingebouwde bitverschuiving naar links is. Het teken is hetzelfde, maar de operandtypen en de bewerking verschillen. Volgens de C++-grammatica is << linksassociatief: out << a << b wordt gegroepeerd als (out << a) << b, ongeacht het retourtype van de gekozen overload. Voor een lvalue out van het type std::ostream geven de gebruikelijke overloads een std::ostream& naar dezelfde stroom terug, zodat de volgende invoeging naar diezelfde stroom kan schrijven. Spaties en regeleinden worden niet automatisch toegevoegd.
Getallen gebruiken overloads van lidfuncties; char en tekst gebruiken overloads die geen lidfunctie zijn. Gebruik liever out << x dan out.operator<<(x), want de expliciete aanroep van de lidfunctie slaat de vrije functies over. Voor invoeging als const char* moet de pointer naar een geldige nulbeëindigde tekenreeks wijzen. std::string en std::string_view gebruiken hun lengte, zodat een ingebed nulteken de uitvoer niet afbreekt. Een std::string_view bezit de gegevens niet: de aangewezen tekens moeten tijdens de hele invoeging geldig blijven.
De opmaak hoort bij de stroom. Zowel out << std::boolalpha als out.setf(std::ios::boolalpha) schakelt locale-afhankelijke namen voor booleans in (true en false in de klassieke locale). De vlag blijft ingesteld totdat je die wist, bijvoorbeeld met std::noboolalpha. std::setw(n) stelt daarentegen een minimale veldbreedte in, die de gewone overloads voor tekens, tekenreeksen en getallen na gebruik op nul zetten.
out << '\n' voegt een regeleinde in zonder expliciet te vragen om de buffer leeg te schrijven. std::endl voegt een regeleinde in en roept flush() aan. Dat je de stroom terugkrijgt, bewijst niet dat het schrijven is gelukt: controleer daarna if (!out). Bij een fout kan failbit of badbit worden ingesteld; afhankelijk van het uitzonderingsmasker van de stroom kan een uitzondering worden geworpen.
Definieer voor een eigen type T een vrije operator<<(std::ostream&, const T&) in de naamruimte van dat type, niet in std. Argumentafhankelijke naamopzoeking (ADL) kan de functie daar vinden. Schrijf naar de doorgegeven stroom en geef die per referentie terug om invoegingen te kunnen koppelen.
Voorbeelden
#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';
}Resultaat
AB: true false shift=8
`report::Result` toont `AB`, omdat de tekenreeksweergave alleen de eerste twee tekens van `ABC` omvat. De vlag `boolalpha` geldt zowel in de eigen overload als voor de daaropvolgende `false`. Op de tweede regel scheiden de haakjes de bitverschuiving die `8` oplevert van het invoegen van die uitkomst.
Gerelateerde lessen
- C++ · Les 1 · Gevorderd · Versie: 3
- C++ · Les 2 · Gevorderd · Versie: 3
- C++ · Les 3 · Gevorderd · Versie: 3
- C++ · Les 4 · Gevorderd · Versie: 3
- C++ · Les 5 · Gevorderd · Versie: 3
- C++ · Les 6 · Gevorderd · Versie: 3
- C++ · Les 7 · Gevorderd · Versie: 3
- C++ · Les 8 · Gevorderd · Versie: 3
- C++ · Les 9 · Gevorderd · Versie: 3
- C++ · Les 10 · Gevorderd · Versie: 3
- C++ · Les 11 · Gevorderd · Versie: 3
- C++ · Les 12 · Gevorderd · Versie: 3
- C++ · Les 13 · Gevorderd · Versie: 3
- C++ · Les 14 · Gevorderd · Versie: 3
- C++ · Les 15 · Gevorderd · Versie: 3
- C++ · Les 16 · Gevorderd · Versie: 3
- C++ · Les 17 · Gevorderd · Versie: 3
- C++ · Les 18 · Gevorderd · Versie: 3
- C++ · Les 19 · Gevorderd · Versie: 3
- C++ · Les 20 · Gevorderd · Versie: 3
- C++ · Les 21 · Gevorderd · Versie: 3
- C++ · Les 22 · Gevorderd · Versie: 3
- C++ · Les 23 · Gevorderd · Versie: 3
- C++ · Les 24 · Gevorderd · Versie: 3
- C++ · Les 25 · Gevorderd · Versie: 3
- C++ · Les 26 · Gevorderd · Versie: 3
- C++ · Les 27 · Gevorderd · Versie: 3
- C++ · Les 28 · Gevorderd · Versie: 3
- C++ · Les 29 · Gevorderd · Versie: 3
- C++ · Les 30 · Gevorderd · Versie: 3
- C++ · Les 31 · Gevorderd · Versie: 3
- C++ · Les 32 · Gevorderd · Versie: 3
- C++ · Les 33 · Gevorderd · Versie: 3
- C++ · Les 34 · Gevorderd · Versie: 3
- C++ · Les 35 · Gevorderd · Versie: 3
- C++ · Les 36 · Gevorderd · Versie: 3
- C++ · Les 37 · Gevorderd · Versie: 3
- C++ · Les 38 · Gevorderd · Versie: 3
- C++ · Les 39 · Gevorderd · Versie: 3
- C++ · Les 40 · Gevorderd · Versie: 3
- C++ · Les 41 · Gevorderd · Versie: 3
- C++ · Les 42 · Gevorderd · Versie: 3
- C++ · Les 43 · Gevorderd · Versie: 3
- C++ · Les 44 · Gevorderd · Versie: 3
- C++ · Les 45 · Gevorderd · Versie: 3
- C++ · Les 46 · Gevorderd · Versie: 3
- C++ · Les 47 · Gevorderd · Versie: 3
- C++ · Les 48 · Gevorderd · Versie: 3
- C++ · Les 49 · Gevorderd · Versie: 3
- C++ · Les 50 · Gevorderd · Versie: 3
- C++ · Les 51 · Gevorderd · Versie: 3
- C++ · Les 52 · Gevorderd · Versie: 3
- C++ · Les 53 · Gevorderd · Versie: 3
- C++ · Les 54 · Gevorderd · Versie: 3
- C++ · Les 55 · Gevorderd · Versie: 3
- C++ · Les 56 · Gevorderd · Versie: 3
- C++ · Les 57 · Gevorderd · Versie: 3
- C++ · Les 58 · Gevorderd · Versie: 3
- C++ · Les 59 · Gevorderd · Versie: 3
- C++ · Les 60 · Gevorderd · Versie: 3
Bronnen
- 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]