WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen