CKTIS / C++
std::fstream: bidirektionaler Dateistream
std::fstream verbindet Zeicheneingabe und -ausgabe mit einer benannten Datei und führt Formatierungs- sowie Fehlerzustand.
Version: 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 aus <fstream> ist der Alias für std::basic_fstream<char> und erbt Ein- und Ausgabeoperationen von std::basic_iostream. Ein enthaltener std::basic_filebuf verknüpft den Stream mit der benannten Datei. Konstruktor und open verwenden standardmäßig std::ios::in | std::ios::out; Flags wie std::ios::trunc, std::ios::app und std::ios::binary bestimmen den Öffnungsmodus.
Das Beispiel öffnet mit std::ios::trunc zum Lesen und Schreiben, schreibt 42 blue, leert den Ausgabepuffer mit flush, setzt die Leseposition durch seekg(0) an den Anfang und liest Zahl und Wort. Deshalb lautet die Ausgabe 42 blue. Der Block schließt den Stream vor std::filesystem::remove; Produktionscode sollte auch Schließfehler prüfen oder Ausnahmen für ausgewählte Zustandsbits aktivieren.
Ein fehlgeschlagenes Öffnen setzt failbit. is_open() meldet nur die Zuordnung des Dateipuffers, während operator bool, fail() und bad() den Operationszustand zeigen. std::ios_base::failure entsteht nur für Bits in exceptions(). Nach EOF muss der Zustand vor erneutem Positionieren gelöscht werden; beim Wechsel zwischen Schreiben und Lesen machen ein ausdrückliches flush und seekg/seekp die gepufferten Positionen eindeutig. Der Stream ist verschiebbar, nicht kopierbar. Textmodus kann Zeilenenden übersetzen; Binärdaten brauchen std::ios::binary.
Beispiele
#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);
}
Ergebnis
42 blue
std::fstream → 42 blue