Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

Operator umetanja u izlazni tok (`<<`)

Operator `<<` zapisuje vrijednosti u izlazni tok ili mijenja njegovo oblikovanje. Tipovi operanada razlikuju umetanje u tok od bitovnog pomaka ulijevo.

Verzija: ISO C++23; implementation support may vary

Sintaksa

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);

U C++23 izraz std::cout << x umeće vrijednost u izlazni tok, dok je 1u << 3 ugrađeni bitovni pomak ulijevo. Znak operatora jednak je, ali se razlikuju tipovi operanada i operacije. Prema gramatici C++-a, << je lijevo asocijativan, pa se out << a << b grupira kao (out << a) << b neovisno o povratnom tipu odabranog preopterećenja. Za lvalue out tipa std::ostream uobičajena preopterećenja vraćaju referencu std::ostream& na isti tok, tako da sljedeće umetanje može pisati u taj isti tok. Razmaci i prijelomi redaka ne dodaju se automatski.

Brojevi koriste preopterećene funkcije članice, a char i tekst preopterećene funkcije koje nisu članice. Koristi out << x umjesto out.operator<<(x) jer izravan poziv članice ne uzima u obzir ostale funkcije. Umetanje vrijednosti tipa const char* traži pokazivač na valjan znakovni niz zaključen nul-znakom. std::string i std::string_view koriste svoju duljinu pa nul-znak unutar niza ne prekida ispis. std::string_view nije vlasnik podataka: znakovi na koje se odnosi moraju ostati valjani tijekom cijelog umetanja.

Oblikovanje je svojstvo toka. I out << std::boolalpha i out.setf(std::ios::boolalpha) uključuju nazive logičkih vrijednosti prema regionalnim postavkama (true i false u klasičnoj postavci). Zastavica ostaje uključena dok je ne isključiš, primjerice pomoću std::noboolalpha. Nasuprot tome, std::setw(n) postavlja najmanju širinu polja koju uobičajena preopterećenja za znakove, nizove i brojeve nakon uporabe vraćaju na nulu.

out << '\n' umeće znak novog retka bez izričitog zahtjeva za pražnjenje izlaznog međuspremnika. std::endl umeće znak novog retka i poziva flush(). Vraćanje toka ne znači da je zapis uspio: nakon zapisa provjeri if (!out). Pogreška može postaviti failbit ili badbit, a ovisno o maski iznimaka toka može doći do bacanja iznimke.

Za vlastiti tip T definiraj operator<<(std::ostream&, const T&) kao funkciju koja nije članica u imenskom prostoru tipa, a ne u std. Pretraživanje ovisno o argumentima (ADL) može je ondje pronaći. Piši u primljeni tok i vrati referencu na njega kako bi se umetanja mogla ulančavati.

Primjeri

#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';
}

Rezultat

AB: true false
shift=8

`report::Result` ispisuje `AB` jer pogled obuhvaća samo prva dva znaka niza `ABC`. Zastavica `boolalpha` vrijedi i unutar vlastitog preopterećenja i za sljedeći `false`. U drugom retku zagrade odvajaju bitovni pomak koji daje `8` od umetanja rezultata.

Povezane lekcije

  • C++ · Lekcija 1 · Napredno · Verzija: 3
  • C++ · Lekcija 2 · Napredno · Verzija: 3
  • C++ · Lekcija 3 · Napredno · Verzija: 3
  • C++ · Lekcija 4 · Napredno · Verzija: 3
  • C++ · Lekcija 5 · Napredno · Verzija: 3
  • C++ · Lekcija 6 · Napredno · Verzija: 3
  • C++ · Lekcija 7 · Napredno · Verzija: 3
  • C++ · Lekcija 8 · Napredno · Verzija: 3
  • C++ · Lekcija 9 · Napredno · Verzija: 3
  • C++ · Lekcija 10 · Napredno · Verzija: 3
  • C++ · Lekcija 11 · Napredno · Verzija: 3
  • C++ · Lekcija 12 · Napredno · Verzija: 3
  • C++ · Lekcija 13 · Napredno · Verzija: 3
  • C++ · Lekcija 14 · Napredno · Verzija: 3
  • C++ · Lekcija 15 · Napredno · Verzija: 3
  • C++ · Lekcija 16 · Napredno · Verzija: 3
  • C++ · Lekcija 17 · Napredno · Verzija: 3
  • C++ · Lekcija 18 · Napredno · Verzija: 3
  • C++ · Lekcija 19 · Napredno · Verzija: 3
  • C++ · Lekcija 20 · Napredno · Verzija: 3
  • C++ · Lekcija 21 · Napredno · Verzija: 3
  • C++ · Lekcija 22 · Napredno · Verzija: 3
  • C++ · Lekcija 23 · Napredno · Verzija: 3
  • C++ · Lekcija 24 · Napredno · Verzija: 3
  • C++ · Lekcija 25 · Napredno · Verzija: 3
  • C++ · Lekcija 26 · Napredno · Verzija: 3
  • C++ · Lekcija 27 · Napredno · Verzija: 3
  • C++ · Lekcija 28 · Napredno · Verzija: 3
  • C++ · Lekcija 29 · Napredno · Verzija: 3
  • C++ · Lekcija 30 · Napredno · Verzija: 3
  • C++ · Lekcija 31 · Napredno · Verzija: 3
  • C++ · Lekcija 32 · Napredno · Verzija: 3
  • C++ · Lekcija 33 · Napredno · Verzija: 3
  • C++ · Lekcija 34 · Napredno · Verzija: 3
  • C++ · Lekcija 35 · Napredno · Verzija: 3
  • C++ · Lekcija 36 · Napredno · Verzija: 3
  • C++ · Lekcija 37 · Napredno · Verzija: 3
  • C++ · Lekcija 38 · Napredno · Verzija: 3
  • C++ · Lekcija 39 · Napredno · Verzija: 3
  • C++ · Lekcija 40 · Napredno · Verzija: 3
  • C++ · Lekcija 41 · Napredno · Verzija: 3
  • C++ · Lekcija 42 · Napredno · Verzija: 3
  • C++ · Lekcija 43 · Napredno · Verzija: 3
  • C++ · Lekcija 44 · Napredno · Verzija: 3
  • C++ · Lekcija 45 · Napredno · Verzija: 3
  • C++ · Lekcija 46 · Napredno · Verzija: 3
  • C++ · Lekcija 47 · Napredno · Verzija: 3
  • C++ · Lekcija 48 · Napredno · Verzija: 3
  • C++ · Lekcija 49 · Napredno · Verzija: 3
  • C++ · Lekcija 50 · Napredno · Verzija: 3
  • C++ · Lekcija 51 · Napredno · Verzija: 3
  • C++ · Lekcija 52 · Napredno · Verzija: 3
  • C++ · Lekcija 53 · Napredno · Verzija: 3
  • C++ · Lekcija 54 · Napredno · Verzija: 3
  • C++ · Lekcija 55 · Napredno · Verzija: 3
  • C++ · Lekcija 56 · Napredno · Verzija: 3
  • C++ · Lekcija 57 · Napredno · Verzija: 3
  • C++ · Lekcija 58 · Napredno · Verzija: 3
  • C++ · Lekcija 59 · Napredno · Verzija: 3
  • C++ · Lekcija 60 · Napredno · Verzija: 3

Izvori