CKTIS / C++
Оператор за вмъкване в изходен поток (`<<`)
Операторът `<<` записва стойности в изходен поток или променя форматирането му. Типовете на операндите разграничават вмъкването от побитовото отместване наляво.
Версия: ISO C++23; implementation support may vary
Синтаксис
out << value;
out << first << second; // (out << first) << second
out << std::boolalpha << flag;
out << (1u << 3); // insert the result of a built-in left shift
// Conventional non-member overload in the namespace of T:
std::ostream& operator<<(std::ostream& out, const T& value);В C++23 std::cout << x вмъква стойност в изходен поток, а 1u << 3 е вградено побитово отместване наляво. Знакът е същият, но типовете на операндите и операциите са различни. Според граматиката на C++ операторът << е лявоасоциативен, затова out << a << b се групира като (out << a) << b независимо от връщания тип на избраното претоварване. За lvalue out от тип std::ostream обичайните претоварвания връщат референция std::ostream& към същия поток, така че следващото вмъкване може да записва в него. Интервали и нови редове не се добавят автоматично.
Числата използват претоварени член-функции, а char и текстът използват претоварени функции, които не са членове. Използвай out << x вместо out.operator<<(x), защото прякото извикване на член-функция пропуска функциите, които не са членове. При вмъкване на const char* указателят трябва да сочи към валиден низ, завършващ с нулев символ. std::string и std::string_view използват дължината си, така че нулев символ в средата не прекъсва извеждането. std::string_view не притежава данните: символите, към които сочи, трябва да останат валидни през цялото вмъкване.
Форматирането е свойство на потока. И out << std::boolalpha, и out.setf(std::ios::boolalpha) включват извеждането на имена на булевите стойности според регионалните настройки (true и false при класическата настройка). Флагът остава включен до изключването му, например с std::noboolalpha. За разлика от него std::setw(n) задава минимална ширина на полето, която обичайните претоварвания за символи, низове и числа връщат на нула след употреба.
out << '\n' вмъква символ за нов ред, без изрично да изисква изпразване на буфера. std::endl вмъква символ за нов ред и извиква flush(). Връщането на потока не означава, че записът е успешен: след него провери if (!out). При грешка може да се установи failbit или badbit и в зависимост от маската за изключения на потока може да се хвърли изключение.
За собствен тип T дефинирай operator<<(std::ostream&, const T&) като функция, която не е член и се намира в пространството от имена на типа, а не в std. Търсенето, зависещо от аргументите (ADL), може да я открие там. Записвай в подадения поток и върни референция към него, за да могат вмъкванията да се свързват във верига.
Примери
#include <ios>
#include <iostream>
#include <locale>
#include <ostream>
#include <string_view>
namespace report {
struct Result {
std::string_view label;
bool ok;
};
std::ostream& operator<<(std::ostream& out, const Result& result) {
return out << result.label << ": " << result.ok;
}
} // namespace report
int main() {
std::cout.imbue(std::locale::classic());
std::cout.setf(std::ios::boolalpha);
const report::Result result{std::string_view{"ABC", 2}, true};
std::cout << result << ' ' << false << '\n';
std::cout << "shift=" << (1u << 3) << '\n';
}Резултат
AB: true false shift=8
`report::Result` извежда `AB`, защото изгледът обхваща само първите два символа на `ABC`. Флагът `boolalpha` действа както в собственото претоварване, така и за следващото `false`. На втория ред скобите отделят побитовото отместване, което дава `8`, от вмъкването на резултата.
Свързани уроци
- C++ · Урок 1 · Напреднало · Версия: 3
- C++ · Урок 2 · Напреднало · Версия: 3
- C++ · Урок 3 · Напреднало · Версия: 3
- C++ · Урок 4 · Напреднало · Версия: 3
- C++ · Урок 5 · Напреднало · Версия: 3
- C++ · Урок 6 · Напреднало · Версия: 3
- C++ · Урок 7 · Напреднало · Версия: 3
- C++ · Урок 8 · Напреднало · Версия: 3
- C++ · Урок 9 · Напреднало · Версия: 3
- C++ · Урок 10 · Напреднало · Версия: 3
- C++ · Урок 11 · Напреднало · Версия: 3
- C++ · Урок 12 · Напреднало · Версия: 3
- C++ · Урок 13 · Напреднало · Версия: 3
- C++ · Урок 14 · Напреднало · Версия: 3
- C++ · Урок 15 · Напреднало · Версия: 3
- C++ · Урок 16 · Напреднало · Версия: 3
- C++ · Урок 17 · Напреднало · Версия: 3
- C++ · Урок 18 · Напреднало · Версия: 3
- C++ · Урок 19 · Напреднало · Версия: 3
- C++ · Урок 20 · Напреднало · Версия: 3
- C++ · Урок 21 · Напреднало · Версия: 3
- C++ · Урок 22 · Напреднало · Версия: 3
- C++ · Урок 23 · Напреднало · Версия: 3
- C++ · Урок 24 · Напреднало · Версия: 3
- C++ · Урок 25 · Напреднало · Версия: 3
- C++ · Урок 26 · Напреднало · Версия: 3
- C++ · Урок 27 · Напреднало · Версия: 3
- C++ · Урок 28 · Напреднало · Версия: 3
- C++ · Урок 29 · Напреднало · Версия: 3
- C++ · Урок 30 · Напреднало · Версия: 3
- C++ · Урок 31 · Напреднало · Версия: 3
- C++ · Урок 32 · Напреднало · Версия: 3
- C++ · Урок 33 · Напреднало · Версия: 3
- C++ · Урок 34 · Напреднало · Версия: 3
- C++ · Урок 35 · Напреднало · Версия: 3
- C++ · Урок 36 · Напреднало · Версия: 3
- C++ · Урок 37 · Напреднало · Версия: 3
- C++ · Урок 38 · Напреднало · Версия: 3
- C++ · Урок 39 · Напреднало · Версия: 3
- C++ · Урок 40 · Напреднало · Версия: 3
- C++ · Урок 41 · Напреднало · Версия: 3
- C++ · Урок 42 · Напреднало · Версия: 3
- C++ · Урок 43 · Напреднало · Версия: 3
- C++ · Урок 44 · Напреднало · Версия: 3
- C++ · Урок 45 · Напреднало · Версия: 3
- C++ · Урок 46 · Напреднало · Версия: 3
- C++ · Урок 47 · Напреднало · Версия: 3
- C++ · Урок 48 · Напреднало · Версия: 3
- C++ · Урок 49 · Напреднало · Версия: 3
- C++ · Урок 50 · Напреднало · Версия: 3
- C++ · Урок 51 · Напреднало · Версия: 3
- C++ · Урок 52 · Напреднало · Версия: 3
- C++ · Урок 53 · Напреднало · Версия: 3
- C++ · Урок 54 · Напреднало · Версия: 3
- C++ · Урок 55 · Напреднало · Версия: 3
- C++ · Урок 56 · Напреднало · Версия: 3
- C++ · Урок 57 · Напреднало · Версия: 3
- C++ · Урок 58 · Напреднало · Версия: 3
- C++ · Урок 59 · Напреднало · Версия: 3
- C++ · Урок 60 · Напреднало · Версия: 3
Източници
- WG21 N4950 — C++23 working draft
- Formatted output functions [ostream.formatted]
- Shift operators [expr.shift]
- Operators in expressions [over.match.oper]
- Argument-dependent name lookup [basic.lookup.argdep]
- String view inserters and extractors [string.view.io]
- String inserters and extractors [string.io]
- fmtflags manipulators [fmtflags.manip]
- Standard manipulators [std.manip]
- Standard basic_ostream manipulators [ostream.manip]
- basic_ios member functions [basic.ios.members]