Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

Operator umetanja u tok <<

Operator << zapisuje vrijednosti u izlazni tok. Upoznajte razliku između članskih preopterećenja i nečlanskih funkcija te saznajte kako podržati vlastiti tip uz očuvanje ulančanog umetanja.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

stream << value;
stream << first << second;
std::ostream& operator<<(std::ostream& os, const T& value);

Izraz stream << value odabire preopterećenje za umetanje u izlazni tok. std::ostream je alias za std::basic_ostream<char>. Simbol std::ostream::operator<< označava članska preopterećenja, uključujući ona za brojeve i pokazivače na funkcije manipulatora. Zapis operator<<(std::ostream&, ...) ovdje označava skup nečlanskih funkcija, a ne deklaraciju varijadične funkcije: ... je opisni zamjenski tekst za dodatne parametre. Standardna preopterećenja za znakove i nizove znakova završene nul-znakom nečlanske su funkcije.

Preopterećenja upotrijebljena u primjeru vraćaju referencu na isti tok, pa stream << first << second radi kao (stream << first) << second. Umetanje automatski ne dodaje razmake ni novi redak. Izričit poziv stream.operator<<('A') zaobilazi nečlanska preopterećenja za znakove i odabire brojčano preopterećenje umjesto ispisa znaka.

Za vlastiti tip definirajte nečlansku funkciju std::ostream& operator<<(std::ostream& os, const T& value) u istom imenskom prostoru kao i tip, a ne u std. Vratite os, obično vraćanjem cijelog izraza umetanja. Primjer primjenjuje taj obrazac na Point i izričito dodaje \n.

Izlaz ovisi o stanju oblikovanja toka; primjerice, manipulatori mogu promijeniti oblik brojeva. Vraćanje reference ne potvrđuje uspješan ispis: provjerite stanje toka, kao što to čini primjer. Dostavljeni izvori trenutačni su nacrt standarda, a ne konačan tekst C++23; lokalna izgradnja s opcijom C++23 ne dokazuje kompatibilnost s produkcijskim okruženjem.

Primjeri

#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;
}

Rezultat

Point: (2, 3)

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori