Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje