CKTIS / C++
Operátor vkládání do výstupního proudu (`<<`)
Operátor `<<` zapisuje hodnoty do výstupního proudu nebo mění jeho formátování. Typy operandů odlišují vkládání do proudu od bitového posunu doleva.
Verze: ISO C++23; implementation support may vary
Syntaxe
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);V C++23 výraz std::cout << x vkládá hodnotu do výstupního proudu, zatímco 1u << 3 je vestavěný bitový posun doleva. Znak operátoru je stejný, ale typy operandů a prováděné operace se liší. Podle gramatiky C++ je << asociativní zleva, takže se out << a << b seskupuje jako (out << a) << b bez ohledu na návratový typ vybraného přetížení. Pro lvalue out typu std::ostream vracejí běžná přetížení referenci std::ostream& na tentýž proud, takže další vkládání může zapisovat do téhož proudu. Mezery ani konce řádků se automaticky nepřidávají.
Čísla používají členská přetížení, char a text nečlenská přetížení. Používej out << x místo out.operator<<(x), protože výslovné volání členské funkce nebere v úvahu nečlenské funkce. Při vkládání const char* musí ukazatel odkazovat na platný řetězec ukončený nulovým znakem. std::string a std::string_view používají svou délku, takže nulový znak uvnitř výstup neukončí. std::string_view data nevlastní: odkazované znaky musí zůstat platné po celou dobu vkládání.
Formátování je vlastnost proudu. out << std::boolalpha i out.setf(std::ios::boolalpha) zapínají výpis názvů logických hodnot podle místního nastavení (true a false v klasickém nastavení). Příznak zůstává nastavený, dokud jej nevypneš, například pomocí std::noboolalpha. Naproti tomu std::setw(n) nastaví minimální šířku pole, kterou běžná přetížení pro znaky, řetězce a čísla po použití vynulují.
out << '\n' vloží znak nového řádku, aniž by výslovně požádal o vyprázdnění vyrovnávací paměti. std::endl vloží znak nového řádku a zavolá flush(). Vrácení proudu neprokazuje úspěšný zápis: poté zkontroluj if (!out). Chyba může nastavit failbit nebo badbit a podle masky výjimek proudu může být vyvolána výjimka.
Pro vlastní typ T definuj nečlenskou funkci operator<<(std::ostream&, const T&) ve jmenném prostoru typu, ne v std. Vyhledávání závislé na argumentech (ADL) ji tam může najít. Zapisuj do předaného proudu a vrať na něj referenci, aby šlo vkládání řetězit.
Příklady
#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';
}Výsledek
AB: true false shift=8
`report::Result` vypíše `AB`, protože pohled zahrnuje jen první dva znaky `ABC`. Příznak `boolalpha` platí uvnitř vlastního přetížení i pro následující `false`. Na druhém řádku závorky oddělují bitový posun s výsledkem `8` od vložení výsledku do proudu.
Související lekce
- C++ · Lekce 1 · Pokročilá · Verze: 3
- C++ · Lekce 2 · Pokročilá · Verze: 3
- C++ · Lekce 3 · Pokročilá · Verze: 3
- C++ · Lekce 4 · Pokročilá · Verze: 3
- C++ · Lekce 5 · Pokročilá · Verze: 3
- C++ · Lekce 6 · Pokročilá · Verze: 3
- C++ · Lekce 7 · Pokročilá · Verze: 3
- C++ · Lekce 8 · Pokročilá · Verze: 3
- C++ · Lekce 9 · Pokročilá · Verze: 3
- C++ · Lekce 10 · Pokročilá · Verze: 3
- C++ · Lekce 11 · Pokročilá · Verze: 3
- C++ · Lekce 12 · Pokročilá · Verze: 3
- C++ · Lekce 13 · Pokročilá · Verze: 3
- C++ · Lekce 14 · Pokročilá · Verze: 3
- C++ · Lekce 15 · Pokročilá · Verze: 3
- C++ · Lekce 16 · Pokročilá · Verze: 3
- C++ · Lekce 17 · Pokročilá · Verze: 3
- C++ · Lekce 18 · Pokročilá · Verze: 3
- C++ · Lekce 19 · Pokročilá · Verze: 3
- C++ · Lekce 20 · Pokročilá · Verze: 3
- C++ · Lekce 21 · Pokročilá · Verze: 3
- C++ · Lekce 22 · Pokročilá · Verze: 3
- C++ · Lekce 23 · Pokročilá · Verze: 3
- C++ · Lekce 24 · Pokročilá · Verze: 3
- C++ · Lekce 25 · Pokročilá · Verze: 3
- C++ · Lekce 26 · Pokročilá · Verze: 3
- C++ · Lekce 27 · Pokročilá · Verze: 3
- C++ · Lekce 28 · Pokročilá · Verze: 3
- C++ · Lekce 29 · Pokročilá · Verze: 3
- C++ · Lekce 30 · Pokročilá · Verze: 3
- C++ · Lekce 31 · Pokročilá · Verze: 3
- C++ · Lekce 32 · Pokročilá · Verze: 3
- C++ · Lekce 33 · Pokročilá · Verze: 3
- C++ · Lekce 34 · Pokročilá · Verze: 3
- C++ · Lekce 35 · Pokročilá · Verze: 3
- C++ · Lekce 36 · Pokročilá · Verze: 3
- C++ · Lekce 37 · Pokročilá · Verze: 3
- C++ · Lekce 38 · Pokročilá · Verze: 3
- C++ · Lekce 39 · Pokročilá · Verze: 3
- C++ · Lekce 40 · Pokročilá · Verze: 3
- C++ · Lekce 41 · Pokročilá · Verze: 3
- C++ · Lekce 42 · Pokročilá · Verze: 3
- C++ · Lekce 43 · Pokročilá · Verze: 3
- C++ · Lekce 44 · Pokročilá · Verze: 3
- C++ · Lekce 45 · Pokročilá · Verze: 3
- C++ · Lekce 46 · Pokročilá · Verze: 3
- C++ · Lekce 47 · Pokročilá · Verze: 3
- C++ · Lekce 48 · Pokročilá · Verze: 3
- C++ · Lekce 49 · Pokročilá · Verze: 3
- C++ · Lekce 50 · Pokročilá · Verze: 3
- C++ · Lekce 51 · Pokročilá · Verze: 3
- C++ · Lekce 52 · Pokročilá · Verze: 3
- C++ · Lekce 53 · Pokročilá · Verze: 3
- C++ · Lekce 54 · Pokročilá · Verze: 3
- C++ · Lekce 55 · Pokročilá · Verze: 3
- C++ · Lekce 56 · Pokročilá · Verze: 3
- C++ · Lekce 57 · Pokročilá · Verze: 3
- C++ · Lekce 58 · Pokročilá · Verze: 3
- C++ · Lekce 59 · Pokročilá · Verze: 3
- C++ · Lekce 60 · Pokročilá · Verze: 3
Zdroje
- 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]