WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::ofstream — in eine Datei schreiben

std::ofstream aus <fstream> schreibt Daten über eine Stream-Schnittstelle in eine Datei. Lerne das standardmäßige Ersetzen des Inhalts, das Anhängen sowie die Prüfung auf Fehler beim Öffnen, Schreiben und Schließen kennen.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <fstream>
std::ofstream out("file.txt");
out << "text\n";
out.close();

std::ofstream aus <fstream> ist ein Alias für std::basic_ofstream<char>. Es stellt einen Ausgabestream bereit, der mit einer Datei verbunden ist; der Operator << führt formatierte Ausgaben aus. Das Objekt kann verschoben, aber nicht kopiert werden.

Ein Konstruktor, der einen Pfad entgegennimmt, versucht sofort, die Datei zu öffnen. std::ios::out erstellt standardmäßig die Datei, sofern möglich, oder verwirft den Inhalt einer bereits vorhandenen Datei. std::ios::trunc drückt dieses Verwerfen ausdrücklich aus. Zum Anhängen verwendest du std::ios::app; damit wird jeder Schreibvorgang ans Dateiende gelenkt. std::ios::ate setzt die Position nur nach dem Öffnen ans Ende und ist kein Ersatz für das Anhängen. std::ios::binary wählt den Binärmodus, macht << aber nicht zu einem ungefilterten Schreiben der Objektrepräsentation.

Prüfe den Zustand mit if (!out) nach dem Öffnen sowie nach dem Schreiben und Schließen. is_open() meldet, ob eine Verbindung zu einer geöffneten Datei besteht, nicht ob alle Schreibvorgänge erfolgreich waren. Standardmäßig werden Streamfehler über Zustandsflags gemeldet; Ausnahmen lassen sich mit exceptions() aktivieren. Die Ausgabe wird gepuffert: Ein Fehler wird möglicherweise erst beim Leeren des Puffers oder bei close() sichtbar.

Beim Zerstören des Objekts wird die Datei automatisch über ihren Puffer geschlossen. Mit einem ausdrücklichen Aufruf von close() kannst du einen Fehler beim Schließen prüfen, bevor der Stream nicht mehr existiert. Das Beispiel überschreibt cktis-ofstream-example.txt im aktuellen Arbeitsverzeichnis und gibt saved erst aus, nachdem der Zustand nach dem Schließen geprüft wurde. Es verwendet Funktionen, die in C++23 verfügbar sind; das verlinkte Dokument ist ein fortlaufend bearbeiteter Standardentwurf und keine endgültige C++23-Ausgabe.

Beispiele

#include <fstream>
#include <iostream>

int main() {
    std::ofstream out("cktis-ofstream-example.txt",
                      std::ios::out | std::ios::trunc);
    if (!out) {
        std::cerr << "open failed\n";
        return 1;
    }

    out << "Hello, file!\n";
    out.close();
    if (!out) {
        std::cerr << "write or close failed\n";
        return 1;
    }

    std::cout << "saved\n";
}

Ergebnis

saved

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen