CKTIS / C++
Operátor vkladania do streamu <<
Operátor << zapisuje hodnoty do výstupného streamu. Spoznajte rozdiel medzi členskými preťaženiami a nečlenskými funkciami a zistite, ako podporovať vlastný typ pri zachovaní reťazenia vkladania.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
stream << value;
stream << first << second;
std::ostream& operator<<(std::ostream& os, const T& value);Výraz stream << value vyberie preťaženie na vkladanie do výstupného streamu. std::ostream je alias pre std::basic_ostream<char>. Symbol std::ostream::operator<< označuje členské preťaženia vrátane preťažení pre čísla a ukazovatele na funkcie manipulátorov. Zápis operator<<(std::ostream&, ...) tu označuje skupinu nečlenských funkcií, nie deklaráciu variadickej funkcie: ... je opisná zástupná značka pre ďalšie parametre. Štandardné preťaženia pre znaky a reťazce ukončené nulovým znakom sú nečlenské funkcie.
Preťaženia použité v príklade vracajú referenciu na ten istý stream, takže stream << first << second funguje ako (stream << first) << second. Vkladanie automaticky nepridáva medzery ani nový riadok. Výslovné volanie stream.operator<<('A') obíde nečlenské preťaženia pre znaky a vyberie číselné preťaženie namiesto vypísania znaku.
Pre vlastný typ definujte nečlenskú funkciu std::ostream& operator<<(std::ostream& os, const T& value) v rovnakom mennom priestore ako typ, nie v std. Vráťte os, zvyčajne vrátením celého výrazu vkladania. Príklad používa tento vzor pre Point a výslovne pridáva \n.
Výstup závisí od stavu formátovania streamu; manipulátory môžu napríklad meniť formát čísel. Vrátenie referencie nepotvrdzuje úspešný zápis: skontrolujte stav streamu, ako to robí príklad. Dodané zdroje sú aktuálnym návrhom štandardu, nie ustáleným textom C++23; miestne zostavenie s voľbou C++23 nepreukazuje kompatibilitu s produkčným behovým prostredím.
Príklady
#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;
}
Výsledok
Point: (2, 3)
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.