CKTIS / C++
std::ostream e std::basic_ostream — flussi di output
std::basic_ostream è un modello di flusso di output e std::ostream è il suo alias per char. Consentono di formattare valori con operator<< e di scrivere caratteri in un buffer di flusso associato.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <ostream>
std::basic_ostream<CharT, Traits>
std::ostream // std::basic_ostream<char, std::char_traits<char>>
std::ostream& write_value(std::ostream& out, int value);std::basic_ostream<CharT, Traits> di <ostream> fornisce un’interfaccia per l’output verso un buffer di flusso. CharT determina il tipo di carattere, mentre Traits fornisce le operazioni sui caratteri; il valore predefinito è std::char_traits<CharT>. std::ostream è esattamente un alias di std::basic_ostream<char>, non un modello distinto né un oggetto di output.
operator<< formatta valori come i numeri. Le operazioni di inserimento restituiscono un riferimento al flusso, consentendo di concatenare le chiamate. put(c) scrive un carattere, mentre write(s, n) scrive n caratteri senza formattarli, a meno che l’output non fallisca. flush() richiede la sincronizzazione del buffer associato; non garantisce che i dati vengano memorizzati in modo duraturo su disco.
Accetta std::ostream& affinché una funzione possa usare il flusso fornito senza copiarlo. Nell’esempio, write_value riceve std::cout e restituisce lo stesso flusso; in seguito put('\n') aggiunge un carattere di nuova riga. Un semplice \n non richiede lo svuotamento del buffer; l’esempio chiama esplicitamente flush().
Gli errori di output vengono segnalati tramite lo stato del flusso, per esempio con failbit o badbit; la maschera delle eccezioni può causare il lancio di un’eccezione. Non presumere che l’assenza di un’eccezione significhi che l’operazione è riuscita: controlla lo stato, come fa la condizione finale dell’esempio. Questa voce riguarda C++23; lo standard di compilazione indicato non attesta un ambiente di esecuzione di produzione. Le fonti presentano una bozza di standard in evoluzione.
Esempi
#include <iostream>
#include <locale>
#include <ostream>
std::ostream& write_value(std::ostream& out, int value) {
return out << "value=" << value;
}
int main() {
std::cout.imbue(std::locale::classic());
write_value(std::cout, 42).put('\n');
std::cout.flush();
return std::cout ? 0 : 1;
}
Risultato
value=42
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.