Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::fstream: stream di file bidirezionale

std::fstream collega input e output di caratteri a un file con nome mantenendo formattazione e stato degli errori.

Versione: C++23

Sintassi

using std::fstream = std::basic_fstream<char>;

explicit std::fstream(const char* path,
    std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);
explicit std::fstream(const std::string& path,
    std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);

void open(const std::filesystem::path& path,
    std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);
void close();
bool is_open() const;

std::fstream di <fstream> è l’alias di std::basic_fstream<char> ed eredita le operazioni di input e output da std::basic_iostream. Il std::basic_filebuf contenuto associa lo stream al file. Costruttore e open richiedono per default std::ios::in | std::ios::out; flag espliciti come std::ios::trunc, std::ios::app e std::ios::binary stabiliscono la modalità di apertura.

L’esempio apre in lettura e scrittura con std::ios::trunc, scrive 42 blue, svuota il buffer con flush, riporta la posizione di lettura all’inizio con seekg(0) ed estrae numero e parola. Stampa quindi 42 blue. Il blocco chiude lo stream prima di std::filesystem::remove; il codice reale dovrebbe controllare anche gli errori di chiusura o abilitare le eccezioni per specifici bit di stato.

Un’apertura fallita imposta failbit. is_open() segnala solo l’associazione del buffer, mentre operator bool, fail() e bad() descrivono lo stato operativo. std::ios_base::failure è lanciata solo per i bit scelti in exceptions(). Dopo EOF bisogna azzerare lo stato prima di riposizionare; nel passaggio scrittura/lettura, flush e seekg/seekp espliciti rendono univoca la posizione bufferizzata. Lo stream è spostabile ma non copiabile. Il modo testo può tradurre i fine riga; i dati binari richiedono std::ios::binary.

Esempi

#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>

int main() {
    const std::filesystem::path path = "cpp-ref-014-fstream.txt";
    {
        std::fstream file(path, std::ios::in | std::ios::out | std::ios::trunc);
        if (!file) return 1;
        file << 42 << ' ' << "blue";
        file.flush();
        file.seekg(0);

        int number{};
        std::string word;
        file >> number >> word;
        if (!file) return 2;
        std::cout << number << ' ' << word << '\n';
    }
    std::filesystem::remove(path);
}

Risultato

42 blue

std::fstream → 42 blue

Fonti