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)
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.