CKTIS / C++
Stream-invoegoperator <<
De operator << schrijft waarden naar een uitvoerstream. Leer het verschil tussen memberoverloads en niet-memberfuncties en hoe je een eigen type ondersteunt zonder de mogelijkheid te verliezen om uitvoerbewerkingen te koppelen.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
stream << value;
stream << first << second;
std::ostream& operator<<(std::ostream& os, const T& value);De expressie stream << value kiest een overload voor invoegen in een uitvoerstream. std::ostream is een alias voor std::basic_ostream<char>. Het symbool std::ostream::operator<< duidt memberoverloads aan, waaronder die voor getallen en functiepointers naar manipulators. operator<<(std::ostream&, ...) duidt hier een familie niet-memberfuncties aan, geen declaratie van een variadische functie: ... is een beschrijvende plaatsaanduiding voor extra parameters. De standaardoverloads voor tekens en null-terminated tekenreeksen zijn niet-memberfuncties.
De overloads in het voorbeeld geven een verwijzing naar dezelfde stream terug. Daarom werkt stream << first << second als (stream << first) << second. Invoegen voegt niet automatisch spaties of een nieuwe regel toe. De expliciete aanroep stream.operator<<('A') omzeilt de niet-memberoverloads voor tekens en kiest een numerieke overload in plaats van het teken af te drukken.
Definieer voor een eigen type een niet-memberfunctie std::ostream& operator<<(std::ostream& os, const T& value) in dezelfde namespace als het type, niet in std. Geef os terug, meestal door de volledige invoegexpressie terug te geven. Het voorbeeld past dit patroon toe op Point en voegt expliciet \n toe.
De uitvoer hangt af van de opmaakstatus van de stream; manipulators kunnen bijvoorbeeld de getalnotatie wijzigen. Een teruggegeven verwijzing bevestigt niet dat de uitvoer is gelukt: controleer de streamstatus, zoals het voorbeeld doet. De geleverde bronnen zijn het huidige standaardconcept, geen vastgelegde C++23-tekst; lokaal bouwen met een C++23-optie toont geen compatibiliteit met de productie-runtime aan.
Voorbeelden
#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;
}
Resultaat
Point: (2, 3)
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.