Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::ofstream — scrivere in un file

std::ofstream di <fstream> scrive dati in un file tramite un’interfaccia a flusso. Scopri la sostituzione predefinita del contenuto, l’aggiunta in coda e il controllo degli errori durante l’apertura, la scrittura e la chiusura.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <fstream>
std::ofstream out("file.txt");
out << "text\n";
out.close();

std::ofstream di <fstream> è un alias di std::basic_ofstream<char>. Fornisce un flusso di output associato a un file; l’operatore << esegue un output formattato. L’oggetto può essere spostato, ma non copiato.

Un costruttore che riceve un percorso tenta immediatamente di aprire il file. Per impostazione predefinita, std::ios::out crea il file, se possibile, oppure elimina il contenuto di un file esistente. std::ios::trunc indica esplicitamente questa eliminazione. Per aggiungere dati in coda, usa std::ios::app, che indirizza ogni scrittura alla fine del file. std::ios::ate posiziona il cursore alla fine solo dopo l’apertura; non sostituisce l’aggiunta in coda. std::ios::binary seleziona la modalità binaria, ma non trasforma << in una scrittura grezza della rappresentazione di un oggetto.

Controlla lo stato con if (!out) dopo l’apertura e dopo la scrittura e la chiusura. is_open() indica che è associato un file aperto, non che tutte le scritture siano riuscite. Per impostazione predefinita, gli errori del flusso sono segnalati tramite flag di stato; è possibile attivare le eccezioni con exceptions(). L’output è bufferizzato: un errore potrebbe diventare visibile solo quando si svuota il buffer o si chiama close().

Quando l’oggetto viene distrutto, il file viene chiuso automaticamente tramite il suo buffer. Una chiamata esplicita a close() consente di controllare eventuali errori di chiusura prima che il flusso cessi di esistere. L’esempio sovrascrive cktis-ofstream-example.txt nella directory di lavoro corrente e stampa saved solo dopo aver controllato lo stato successivo alla chiusura. Usa funzionalità disponibili in C++23; il documento collegato è una bozza di standard in evoluzione, non un’edizione C++23 definitiva.

Esempi

#include <fstream>
#include <iostream>

int main() {
    std::ofstream out("cktis-ofstream-example.txt",
                      std::ios::out | std::ios::trunc);
    if (!out) {
        std::cerr << "open failed\n";
        return 1;
    }

    out << "Hello, file!\n";
    out.close();
    if (!out) {
        std::cerr << "write or close failed\n";
        return 1;
    }

    std::cout << "saved\n";
}

Risultato

saved

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.

Fonti