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
- 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]