База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

Оператор за вмъкване в поток <<

Операторът << записва стойности в изходен поток. Научете разликата между претоварванията, реализирани като член-функции, и свободните функции, както и как да поддържате собствен тип, без да губите верижното вмъкване.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

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

Изразът stream << value избира претоварване за вмъкване в изходен поток. std::ostream е псевдоним на std::basic_ostream<char>. Символът std::ostream::operator<< обозначава претоварванията, реализирани като член-функции, включително тези за числа и указатели към функции-манипулатори. Тук operator<<(std::ostream&, ...) обозначава семейство от свободни функции, а не декларация на вариадична функция: ... е описателен заместител за допълнителни параметри. Стандартните претоварвания за символи и низове, завършващи с нулев символ, са свободни функции.

Претоварванията в примера връщат препратка към същия поток, затова stream << first << second работи като (stream << first) << second. Вмъкването не добавя автоматично интервали или нов ред. Изричното извикване stream.operator<<('A') заобикаля свободните претоварвания за символи и избира числово претоварване вместо да отпечата символа.

За собствен тип дефинирайте свободна функция std::ostream& operator<<(std::ostream& os, const T& value) в същото пространство от имена като типа, а не в std. Върнете os, обикновено като върнете целия израз за вмъкване. Примерът прилага този шаблон към Point и изрично добавя \n.

Изходът зависи от състоянието на форматиране на потока; например манипулаторите могат да променят форматирането на числата. Връщането на препратка не потвърждава успешен изход: проверете състоянието на потока, както прави примерът. Предоставените източници са текущият проект на стандарта, а не окончателен текст на C++23; локално изграждане с опция C++23 не доказва съвместимост с производствената среда за изпълнение.

Примери

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

Резултат

Point: (2, 3)

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници