Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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