KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::fstream: bidirectionele bestandsstream

std::fstream koppelt tekeninvoer en -uitvoer aan een benoemd bestand en bewaart formatterings- en foutstatus.

Versie: C++23

Syntax

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 uit <fstream> is de alias van std::basic_fstream<char> en erft invoer- en uitvoerbewerkingen van std::basic_iostream. De ingebouwde std::basic_filebuf koppelt de stream aan het bestand. Constructor en open vragen standaard std::ios::in | std::ios::out; expliciete vlaggen zoals std::ios::trunc, std::ios::app en std::ios::binary bepalen de openingsmodus.

Het voorbeeld opent voor lezen en schrijven met std::ios::trunc, schrijft 42 blue, leegt de buffer via flush, zet de leespositie met seekg(0) terug naar het begin en leest een getal en woord. Daarom verschijnt 42 blue. Het blok sluit de stream vóór std::filesystem::remove; productiecode moet ook sluitfouten vaststellen of uitzonderingen voor gekozen statusbits inschakelen.

Mislukt openen zet failbit. is_open() meldt alleen de bufferkoppeling, terwijl operator bool, fail() en bad() de bewerkingsstatus melden. std::ios_base::failure wordt alleen voor bits in exceptions() geworpen. Wis na EOF de status voordat opnieuw wordt gezocht; bij wisselen tussen schrijven en lezen maken expliciete flush en seekg/seekp de gebufferde positie eenduidig. De stream is verplaatsbaar maar niet kopieerbaar. Tekstmodus kan regeleinden vertalen; binaire gegevens vereisen std::ios::binary.

Voorbeelden

#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);
}

Resultaat

42 blue

std::fstream → 42 blue

Bronnen