CKTIS / C++
std::ifstream: Dateieingabestream
std::ifstream verbindet Zeicheneingabe mit einer Datei und führt Formatierungs-, EOF- und Fehlerzustand.
Version: C++23
Syntax
using std::ifstream = std::basic_ifstream<char>;
explicit std::ifstream(const char* path,
std::ios_base::openmode mode = std::ios_base::in);
explicit std::ifstream(const std::filesystem::path& path,
std::ios_base::openmode mode = std::ios_base::in);
void open(const std::filesystem::path& path,
std::ios_base::openmode mode = std::ios_base::in);
void close();
bool is_open() const;std::ifstream aus <fstream> ist der Alias std::basic_ifstream<char>. Er enthält einen std::basic_filebuf und erbt formatierte sowie unformatierte Eingabe von std::basic_istream. Konstruktor oder open ergänzt den Modus um std::ios::in; std::ios::binary deaktiviert gegebenenfalls plattformspezifische Textübersetzungen. Die Datei kann durch std::filesystem::path benannt werden.
Das Beispiel erzeugt zuerst eine Datei mit 12 cyan, öffnet sie dann per std::ifstream, liest Zahl und Wort und gibt 12 cyan aus. if (!input) prüft die Extraktion; ein ausdrückliches close geht dem Löschen der Datei voraus.
Fehlgeschlagenes Öffnen setzt failbit. is_open() meldet die Pufferzuordnung, während operator bool, fail(), bad() und eof() den Operationszustand zeigen. std::ios_base::failure wird nur für in exceptions() aktivierte Bits geworfen. Nach EOF ist vor erneutem seekg meist clear() nötig. Der Stream ist verschiebbar, nicht kopierbar. Der Destruktor schließt; für diagnostizierbare Schließfehler nutze close und prüfe den Zustand.
Beispiele
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>
int main() {
const std::filesystem::path path = "cpp-ref-015-ifstream.txt";
{
std::ofstream output(path);
output << "12 cyan\n";
}
std::ifstream input(path);
int number{};
std::string word;
input >> number >> word;
if (!input) return 1;
std::cout << number << ' ' << word << '\n';
input.close();
std::filesystem::remove(path);
}
Ergebnis
12 cyan
std::ifstream → 12 cyan