CKTIS / C++
Operatore di inserimento nei flussi <<
L’operatore << scrive valori in un flusso di output. Scopri la differenza tra overload membro e funzioni non membro e come supportare un tipo personalizzato mantenendo l’inserimento concatenato.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
stream << value;
stream << first << second;
std::ostream& operator<<(std::ostream& os, const T& value);L’espressione stream << value seleziona un overload di inserimento in un flusso di output. std::ostream è un alias di std::basic_ostream<char>. Il simbolo std::ostream::operator<< indica gli overload membro, compresi quelli per i numeri e per i puntatori a funzione manipolatrice. Qui, operator<<(std::ostream&, ...) indica una famiglia di funzioni non membro, non la dichiarazione di una funzione variadica: ... è un segnaposto descrittivo per parametri aggiuntivi. Gli overload standard per i caratteri e le stringhe terminate da null sono funzioni non membro.
Gli overload usati nell’esempio restituiscono un riferimento allo stesso flusso, quindi stream << first << second funziona come (stream << first) << second. L’inserimento non aggiunge automaticamente spazi o nuove righe. La chiamata esplicita stream.operator<<('A') evita gli overload non membro per i caratteri e seleziona un overload numerico invece di stampare il carattere.
Per un tipo personalizzato, definisci una funzione non membro std::ostream& operator<<(std::ostream& os, const T& value) nello stesso namespace del tipo, non in std. Restituisci os, di solito restituendo l’intera espressione di inserimento. L’esempio applica questo schema a Point e aggiunge esplicitamente \n.
L’output dipende dallo stato di formattazione del flusso; per esempio, i manipolatori possono modificare il formato dei numeri. Restituire un riferimento non conferma che la scrittura sia riuscita: controlla lo stato del flusso, come fa l’esempio. Le fonti fornite sono la bozza attuale dello standard, non un testo C++23 definitivo; una compilazione locale con un’opzione C++23 non dimostra la compatibilità con l’ambiente di produzione.
Esempi
#include <iostream>
struct Point {
int x;
int y;
};
std::ostream& operator<<(std::ostream& os, const Point& point) {
return os << '(' << point.x << ", " << point.y << ')';
}
int main() {
const Point point{2, 3};
std::cout << "Point: " << point << '\n';
return std::cout ? 0 : 1;
}
Risultato
Point: (2, 3)
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.