CKTIS / C++
Operátor vkládání do streamu <<
Operátor << zapisuje hodnoty do výstupního streamu. Poznejte rozdíl mezi členskými přetíženími a nečlenskými funkcemi a zjistěte, jak podporovat vlastní typ při zachování řetězení vkládání.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
stream << value;
stream << first << second;
std::ostream& operator<<(std::ostream& os, const T& value);Výraz stream << value vybere přetížení pro vkládání do výstupního streamu. std::ostream je alias pro std::basic_ostream<char>. Symbol std::ostream::operator<< označuje členská přetížení, mimo jiné pro čísla a ukazatele na funkce manipulátorů. Zápis operator<<(std::ostream&, ...) zde označuje skupinu nečlenských funkcí, nikoli deklaraci variadické funkce: ... je popisný zástupný symbol pro další parametry. Standardní přetížení pro znaky a řetězce zakončené nulovým znakem jsou nečlenské funkce.
Přetížení použitá v příkladu vracejí referenci na tentýž stream, takže stream << first << second funguje jako (stream << first) << second. Vkládání automaticky nepřidává mezery ani nový řádek. Výslovné volání stream.operator<<('A') obchází nečlenská přetížení pro znaky a vybere číselné přetížení místo vypsání znaku.
Pro vlastní typ definujte nečlenskou funkci std::ostream& operator<<(std::ostream& os, const T& value) ve stejném jmenném prostoru jako typ, nikoli v std. Vraťte os, obvykle vrácením celého výrazu vkládání. Příklad používá tento vzor pro Point a výslovně přidává \n.
Výstup závisí na stavu formátování streamu; manipulátory mohou například měnit formát čísel. Vrácení reference nepotvrzuje úspěšnost výstupu: zkontrolujte stav streamu, jak to dělá příklad. Dodané zdroje jsou aktuálním návrhem standardu, nikoli ustáleným textem C++23; místní sestavení s volbou C++23 neprokazuje kompatibilitu s produkčním běhovým prostředím.
Pří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ýsledek
Point: (2, 3)
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.