Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

Operator vstavljanja v tok <<

Operator << zapisuje vrednosti v izhodni tok. Spoznajte razliko med članskimi preobremenitvami in nečlanskimi funkcijami ter izvedite, kako podpreti lasten tip in ohraniti veriženje vstavljanja.

Različica: 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 izbere preobremenitev za vstavljanje v izhodni tok. std::ostream je vzdevek za std::basic_ostream<char>. Simbol std::ostream::operator<< označuje članske preobremenitve, med drugim za števila in kazalce na funkcije manipulatorjev. Zapis operator<<(std::ostream&, ...) tukaj označuje družino nečlanskih funkcij, ne deklaracije variadične funkcije: ... je opisno nadomestilo za dodatne parametre. Standardne preobremenitve za znake in nize, zaključene z ničelnim znakom, so nečlanske funkcije.

Preobremenitve v primeru vrnejo sklic na isti tok, zato stream << first << second deluje kot (stream << first) << second. Vstavljanje samodejno ne dodaja presledkov ali nove vrstice. Izrecni klic stream.operator<<('A') zaobide nečlanske preobremenitve za znake in izbere številsko preobremenitev namesto izpisa znaka.

Za lasten tip določite nečlansko funkcijo std::ostream& operator<<(std::ostream& os, const T& value) v istem imenskem prostoru kot tip, ne v std. Vrnite os, običajno tako, da vrnete celoten izraz vstavljanja. Primer uporabi ta vzorec za Point in izrecno doda \n.

Izhod je odvisen od stanja oblikovanja toka; manipulatorji lahko na primer spremenijo obliko števil. Vrnjen sklic ne potrjuje uspešnega izpisa: preverite stanje toka, kot to stori primer. Priloženi viri so trenutni osnutek standarda, ne dokončno besedilo C++23; lokalna gradnja z možnostjo C++23 ne dokazuje združljivosti s produkcijskim izvajalnim okoljem.

Primeri

#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)

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri