CKTIS / C++
Operatore di inserimento in un flusso di output (`<<`)
`<<` scrive valori in un flusso di output o ne modifica la formattazione. I tipi degli operandi distinguono l’inserimento dallo scorrimento dei bit a sinistra.
Versione: ISO C++23; implementation support may vary
Sintassi
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);In C++23, std::cout << x inserisce un valore in un flusso di output, mentre 1u << 3 è uno scorrimento bit a bit a sinistra previsto dal linguaggio. Il simbolo è lo stesso, ma cambiano i tipi degli operandi e l’operazione. Secondo la grammatica del C++, << è associativo a sinistra, quindi out << a << b si raggruppa come (out << a) << b, indipendentemente dal tipo restituito dall’overload selezionato. Per un lvalue out di tipo std::ostream, gli overload consueti restituiscono un riferimento std::ostream& allo stesso flusso, così l’inserimento successivo può scrivere in quel flusso. Non vengono aggiunti automaticamente spazi o caratteri di fine riga.
I numeri usano overload di funzioni membro; char e il testo usano overload di funzioni non membro. Preferisci out << x a out.operator<<(x), perché la chiamata esplicita al membro esclude le funzioni non membro. L’inserimento di un const char* richiede un puntatore a una stringa valida terminata da un carattere nullo. std::string e std::string_view usano la loro lunghezza, quindi un carattere nullo interno non interrompe l’output. std::string_view non possiede i dati: i caratteri a cui si riferisce devono restare validi per tutto l’inserimento.
La formattazione appartiene al flusso. Sia out << std::boolalpha sia out.setf(std::ios::boolalpha) attivano i nomi dei booleani previsti dalla locale (true e false nella locale classica). Il flag rimane attivo finché non viene disattivato, per esempio con std::noboolalpha. Invece std::setw(n) imposta una larghezza minima del campo che i normali overload per caratteri, stringhe e numeri riportano a zero dopo l’uso.
out << '\n' inserisce un carattere di fine riga senza richiedere esplicitamente lo svuotamento del buffer. std::endl inserisce un carattere di fine riga e chiama flush(). Riottenere il flusso non dimostra che la scrittura sia riuscita: controlla poi if (!out). Un errore può impostare failbit o badbit; a seconda della maschera delle eccezioni del flusso, può essere lanciata un’eccezione.
Per un tuo tipo T, definisci un operator<<(std::ostream&, const T&) non membro nello spazio dei nomi del tipo, non in std. La ricerca dipendente dagli argomenti (ADL) può trovarlo lì. Scrivi nel flusso ricevuto e restituiscilo per riferimento, così da consentire il concatenamento.
Esempi
#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';
}Risultato
AB: true false shift=8
`report::Result` stampa `AB` perché la vista comprende solo i primi due caratteri di `ABC`. Il flag `boolalpha` vale sia all’interno dell’overload personalizzato sia per il successivo `false`. Nella seconda riga le parentesi separano lo scorrimento che produce `8` dall’inserimento del risultato.
Lezioni correlate
- C++ · Lezione 1 · Avanzato · Versione: 3
- C++ · Lezione 2 · Avanzato · Versione: 3
- C++ · Lezione 3 · Avanzato · Versione: 3
- C++ · Lezione 4 · Avanzato · Versione: 3
- C++ · Lezione 5 · Avanzato · Versione: 3
- C++ · Lezione 6 · Avanzato · Versione: 3
- C++ · Lezione 7 · Avanzato · Versione: 3
- C++ · Lezione 8 · Avanzato · Versione: 3
- C++ · Lezione 9 · Avanzato · Versione: 3
- C++ · Lezione 10 · Avanzato · Versione: 3
- C++ · Lezione 11 · Avanzato · Versione: 3
- C++ · Lezione 12 · Avanzato · Versione: 3
- C++ · Lezione 13 · Avanzato · Versione: 3
- C++ · Lezione 14 · Avanzato · Versione: 3
- C++ · Lezione 15 · Avanzato · Versione: 3
- C++ · Lezione 16 · Avanzato · Versione: 3
- C++ · Lezione 17 · Avanzato · Versione: 3
- C++ · Lezione 18 · Avanzato · Versione: 3
- C++ · Lezione 19 · Avanzato · Versione: 3
- C++ · Lezione 20 · Avanzato · Versione: 3
- C++ · Lezione 21 · Avanzato · Versione: 3
- C++ · Lezione 22 · Avanzato · Versione: 3
- C++ · Lezione 23 · Avanzato · Versione: 3
- C++ · Lezione 24 · Avanzato · Versione: 3
- C++ · Lezione 25 · Avanzato · Versione: 3
- C++ · Lezione 26 · Avanzato · Versione: 3
- C++ · Lezione 27 · Avanzato · Versione: 3
- C++ · Lezione 28 · Avanzato · Versione: 3
- C++ · Lezione 29 · Avanzato · Versione: 3
- C++ · Lezione 30 · Avanzato · Versione: 3
- C++ · Lezione 31 · Avanzato · Versione: 3
- C++ · Lezione 32 · Avanzato · Versione: 3
- C++ · Lezione 33 · Avanzato · Versione: 3
- C++ · Lezione 34 · Avanzato · Versione: 3
- C++ · Lezione 35 · Avanzato · Versione: 3
- C++ · Lezione 36 · Avanzato · Versione: 3
- C++ · Lezione 37 · Avanzato · Versione: 3
- C++ · Lezione 38 · Avanzato · Versione: 3
- C++ · Lezione 39 · Avanzato · Versione: 3
- C++ · Lezione 40 · Avanzato · Versione: 3
- C++ · Lezione 41 · Avanzato · Versione: 3
- C++ · Lezione 42 · Avanzato · Versione: 3
- C++ · Lezione 43 · Avanzato · Versione: 3
- C++ · Lezione 44 · Avanzato · Versione: 3
- C++ · Lezione 45 · Avanzato · Versione: 3
- C++ · Lezione 46 · Avanzato · Versione: 3
- C++ · Lezione 47 · Avanzato · Versione: 3
- C++ · Lezione 48 · Avanzato · Versione: 3
- C++ · Lezione 49 · Avanzato · Versione: 3
- C++ · Lezione 50 · Avanzato · Versione: 3
- C++ · Lezione 51 · Avanzato · Versione: 3
- C++ · Lezione 52 · Avanzato · Versione: 3
- C++ · Lezione 53 · Avanzato · Versione: 3
- C++ · Lezione 54 · Avanzato · Versione: 3
- C++ · Lezione 55 · Avanzato · Versione: 3
- C++ · Lezione 56 · Avanzato · Versione: 3
- C++ · Lezione 57 · Avanzato · Versione: 3
- C++ · Lezione 58 · Avanzato · Versione: 3
- C++ · Lezione 59 · Avanzato · Versione: 3
- C++ · Lezione 60 · Avanzato · Versione: 3
Fonti
- 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]