Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Operator wstawiania do strumienia <<

Operator << zapisuje wartości do strumienia wyjściowego. Poznaj różnicę między przeciążeniami składowymi i wolnymi funkcjami oraz sposób dodania obsługi własnego typu z zachowaniem łańcuchowania.

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

Składnia

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

Wyrażenie stream << value wybiera przeciążenie operatora wstawiania do strumienia wyjściowego. std::ostream jest aliasem std::basic_ostream<char>. Symbol std::ostream::operator<< oznacza przeciążenia składowe, m.in. dla liczb oraz wskaźników do funkcji manipulatorów. Zapis operator<<(std::ostream&, ...) oznacza tu rodzinę wolnych funkcji, a nie deklarację funkcji wariadycznej: ... zastępuje opisowo kolejne parametry. Standardowe przeciążenia dla znaków i napisów zakończonych znakiem zerowym są wolnymi funkcjami.

Przeciążenia użyte w przykładzie zwracają referencję do tego samego strumienia, więc stream << first << second działa jak (stream << first) << second. Wstawianie nie dodaje automatycznie spacji ani końca wiersza. Jawne wywołanie stream.operator<<('A') omija wolne funkcje dla znaków i wybiera przeciążenie liczbowe, zamiast wypisać znak.

Dla własnego typu zdefiniuj wolną funkcję std::ostream& operator<<(std::ostream& os, const T& value) w tej samej przestrzeni nazw co typ, nie w std. Zwróć os, zwykle przez zwrócenie całego wyrażenia wstawiania. Przykład stosuje ten wzorzec dla Point i dopisuje jawnie \n.

Zapis zależy od stanu formatowania strumienia; przykładowo manipulatory mogą zmieniać format liczb. Zwrócenie referencji nie potwierdza powodzenia zapisu: sprawdź stan strumienia, jak w przykładzie. Dostarczone źródła są bieżącym szkicem standardu, nie zamrożonym tekstem C++23; lokalna kompilacja z flagą C++23 nie potwierdza zgodności środowiska produkcyjnego.

Przykłady

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

Wynik

Point: (2, 3)

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła