CKTIS / C++
Operator wstawiania do strumienia wyjściowego (`<<`)
Operator `<<` zapisuje wartości w strumieniu wyjściowym lub zmienia jego formatowanie. Typy operandów decydują, czy jest to wstawianie do strumienia, czy przesunięcie bitowe.
Wersja: ISO C++23; implementation support may vary
Składnia
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);W C++23 zapis std::cout << x oznacza wstawianie do strumienia, natomiast 1u << 3 to wbudowane przesunięcie bitowe w lewo. Te same znaki, ale inne typy operandów i inne działanie. Zgodnie z gramatyką C++ operator << jest lewostronnie łączny, więc out << a << b grupuje się jako (out << a) << b niezależnie od typu zwracanego przez wybrane przeciążenie. Dla strumienia out typu std::ostream użytego jako l-wartość typowe przeciążenia zwracają std::ostream& do tego samego strumienia, dzięki czemu następne wstawienie odbywa się w tym samym strumieniu. Operator nie dodaje sam spacji ani nowych wierszy.
Liczby obsługują przeciążenia składowe, a znak char i tekst — przeciążenia nieskładowe. Używaj out << x, a nie out.operator<<(x), bo jawne wywołanie składowej pomija funkcje nieskładowe. Wstawienie const char* wymaga wskaźnika do poprawnego napisu zakończonego znakiem zerowym. std::string i std::string_view korzystają ze swojej długości, więc znak zerowy wewnątrz nie kończy zapisu. std::string_view nie jest właścicielem danych: znaki muszą pozostawać dostępne przez cały zapis.
Formatowanie należy do strumienia. Zarówno out << std::boolalpha, jak i out.setf(std::ios::boolalpha) włączają zapis wartości bool słowami zależnymi od ustawień regionalnych (true i false w klasycznych ustawieniach). Flaga pozostaje ustawiona do czasu jej wyłączenia, np. przez std::noboolalpha. Natomiast std::setw(n) ustawia minimalną szerokość pola, którą typowe operacje wstawiania znaków, napisów i liczb zerują po użyciu.
out << '\n' wstawia znak nowego wiersza bez jawnego żądania opróżnienia bufora. std::endl wstawia znak nowego wiersza i wywołuje flush(). Zwrócenie strumienia nie oznacza sukcesu: sprawdź if (!out) po zapisie. Błąd może ustawić failbit lub badbit, a maska wyjątków strumienia może sprawić, że zostanie zgłoszony wyjątek.
Dla własnego typu T zdefiniuj nieskładowy operator<<(std::ostream&, const T&) w przestrzeni nazw typu, nie w std. Wyszukiwanie zależne od argumentów (ADL) może go tam znaleźć. Zapisuj do przekazanego strumienia i zwracaj referencję do niego, aby działało łączenie operacji.
Przykłady
#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';
}Wynik
AB: true false shift=8
`report::Result` wypisuje `AB`, bo widok obejmuje tylko dwa pierwsze znaki `ABC`. Flaga `boolalpha` działa zarówno we własnym przeciążeniu, jak i przy następnym `false`. W drugim wierszu nawiasy oddzielają przesunięcie bitowe dające `8` od wstawiania wyniku do strumienia.
Powiązane lekcje
- C++ · Lekcja 1 · Zaawansowany · Wersja: 3
- C++ · Lekcja 2 · Zaawansowany · Wersja: 3
- C++ · Lekcja 3 · Zaawansowany · Wersja: 3
- C++ · Lekcja 4 · Zaawansowany · Wersja: 3
- C++ · Lekcja 5 · Zaawansowany · Wersja: 3
- C++ · Lekcja 6 · Zaawansowany · Wersja: 3
- C++ · Lekcja 7 · Zaawansowany · Wersja: 3
- C++ · Lekcja 8 · Zaawansowany · Wersja: 3
- C++ · Lekcja 9 · Zaawansowany · Wersja: 3
- C++ · Lekcja 10 · Zaawansowany · Wersja: 3
- C++ · Lekcja 11 · Zaawansowany · Wersja: 3
- C++ · Lekcja 12 · Zaawansowany · Wersja: 3
- C++ · Lekcja 13 · Zaawansowany · Wersja: 3
- C++ · Lekcja 14 · Zaawansowany · Wersja: 3
- C++ · Lekcja 15 · Zaawansowany · Wersja: 3
- C++ · Lekcja 16 · Zaawansowany · Wersja: 3
- C++ · Lekcja 17 · Zaawansowany · Wersja: 3
- C++ · Lekcja 18 · Zaawansowany · Wersja: 3
- C++ · Lekcja 19 · Zaawansowany · Wersja: 3
- C++ · Lekcja 20 · Zaawansowany · Wersja: 3
- C++ · Lekcja 21 · Zaawansowany · Wersja: 3
- C++ · Lekcja 22 · Zaawansowany · Wersja: 3
- C++ · Lekcja 23 · Zaawansowany · Wersja: 3
- C++ · Lekcja 24 · Zaawansowany · Wersja: 3
- C++ · Lekcja 25 · Zaawansowany · Wersja: 3
- C++ · Lekcja 26 · Zaawansowany · Wersja: 3
- C++ · Lekcja 27 · Zaawansowany · Wersja: 3
- C++ · Lekcja 28 · Zaawansowany · Wersja: 3
- C++ · Lekcja 29 · Zaawansowany · Wersja: 3
- C++ · Lekcja 30 · Zaawansowany · Wersja: 3
- C++ · Lekcja 31 · Zaawansowany · Wersja: 3
- C++ · Lekcja 32 · Zaawansowany · Wersja: 3
- C++ · Lekcja 33 · Zaawansowany · Wersja: 3
- C++ · Lekcja 34 · Zaawansowany · Wersja: 3
- C++ · Lekcja 35 · Zaawansowany · Wersja: 3
- C++ · Lekcja 36 · Zaawansowany · Wersja: 3
- C++ · Lekcja 37 · Zaawansowany · Wersja: 3
- C++ · Lekcja 38 · Zaawansowany · Wersja: 3
- C++ · Lekcja 39 · Zaawansowany · Wersja: 3
- C++ · Lekcja 40 · Zaawansowany · Wersja: 3
- C++ · Lekcja 41 · Zaawansowany · Wersja: 3
- C++ · Lekcja 42 · Zaawansowany · Wersja: 3
- C++ · Lekcja 43 · Zaawansowany · Wersja: 3
- C++ · Lekcja 44 · Zaawansowany · Wersja: 3
- C++ · Lekcja 45 · Zaawansowany · Wersja: 3
- C++ · Lekcja 46 · Zaawansowany · Wersja: 3
- C++ · Lekcja 47 · Zaawansowany · Wersja: 3
- C++ · Lekcja 48 · Zaawansowany · Wersja: 3
- C++ · Lekcja 49 · Zaawansowany · Wersja: 3
- C++ · Lekcja 50 · Zaawansowany · Wersja: 3
- C++ · Lekcja 51 · Zaawansowany · Wersja: 3
- C++ · Lekcja 52 · Zaawansowany · Wersja: 3
- C++ · Lekcja 53 · Zaawansowany · Wersja: 3
- C++ · Lekcja 54 · Zaawansowany · Wersja: 3
- C++ · Lekcja 55 · Zaawansowany · Wersja: 3
- C++ · Lekcja 56 · Zaawansowany · Wersja: 3
- C++ · Lekcja 57 · Zaawansowany · Wersja: 3
- C++ · Lekcja 58 · Zaawansowany · Wersja: 3
- C++ · Lekcja 59 · Zaawansowany · Wersja: 3
- C++ · Lekcja 60 · Zaawansowany · Wersja: 3
Źródła
- 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]