Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

Operator za vstavljanje v izhodni tok (`<<`)

Operator `<<` zapisuje vrednosti v izhodni tok ali spreminja njegovo oblikovanje. Tipi operandov ločijo vstavljanje v tok od bitnega pomika v levo.

Različica: 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);

V C++23 izraz std::cout << x vstavi vrednost v izhodni tok, medtem ko je 1u << 3 vgrajeni bitni pomik v levo. Znak operatorja je enak, tipi operandov in operaciji pa se razlikujejo. Po slovnici C++ je << levo asociativen, zato se out << a << b združi kot (out << a) << b ne glede na povratni tip izbrane preobremenitve. Za lvalue out tipa std::ostream običajne preobremenitve vrnejo referenco std::ostream& na isti tok, tako da lahko naslednje vstavljanje piše v isti tok. Presledki in prelomi vrstic se ne dodajo samodejno.

Števila uporabljajo članske preobremenitve, char in besedilo pa nečlanske. Uporabi out << x namesto out.operator<<(x), ker izrecni klic članske funkcije ne upošteva nečlanskih funkcij. Pri vstavljanju const char* mora kazalec kazati na veljaven niz z zaključnim ničelnim znakom. std::string in std::string_view uporabljata svojo dolžino, zato ničelni znak znotraj niza ne prekine izpisa. std::string_view ni lastnik podatkov: znaki, na katere se sklicuje, morajo ostati veljavni med celotnim vstavljanjem.

Oblikovanje je lastnost toka. Tako out << std::boolalpha kot out.setf(std::ios::boolalpha) vklopita imena logičnih vrednosti glede na področne nastavitve (true in false pri klasični nastavitvi). Zastavica ostane nastavljena, dokler je ne izklopiš, na primer z std::noboolalpha. Nasprotno pa std::setw(n) nastavi najmanjšo širino polja, ki jo običajne preobremenitve za znake, nize in števila po uporabi ponastavijo na nič.

out << '\n' vstavi znak za novo vrstico, ne da bi izrecno zahteval praznjenje medpomnilnika. std::endl vstavi znak za novo vrstico in pokliče flush(). Vrnjeni tok še ne pomeni uspešnega zapisa: nato preveri if (!out). Napaka lahko nastavi failbit ali badbit, maska izjem toka pa lahko povzroči, da se sproži izjema.

Za lasten tip T definiraj nečlanski operator<<(std::ostream&, const T&) v imenskem prostoru tipa in ne v std. Iskanje imen, odvisno od argumentov (ADL), ga lahko tam najde. Piši v prejeti tok in ga vrni po referenci, da lahko vstavljanja verižiš.

Primeri

#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` izpiše `AB`, ker pogled zajema le prva dva znaka niza `ABC`. Zastavica `boolalpha` velja znotraj lastne preobremenitve in za naslednji `false`. V drugi vrstici oklepaji ločijo bitni pomik, ki da `8`, od vstavljanja rezultata.

Povezane lekcije

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

Viri