std::fopen

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

C-Style I/O

Typen und Objekte
FILE fpos_t	stdinstdoutstderr
Funktionen
Datei-Zugriff fopen freopen fclose fflush fwide setbuf setvbuf Direkte Ein-/Ausgabe fread fwrite Unformatierte Ein-/Ausgabe fgetcgetc fgets fputcputc fputs getchar gets (bis C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc Formatierte Eingabe scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	Formatierte Ausgabe printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove rename tmpfile tmpnam

 

Definiert in Header <cstdio>
std::FILE* fopen( const char* filename, const char* mode );

Öffnet eine Datei, die durch filename angegeben ist, und gibt einen Dateistream zurück, der mit dieser Datei verbunden ist. mode wird zur Bestimmung des Dateizugriffsmodus verwendet.

Parameter

filename	-	Dateiname, dem der Dateistream zugeordnet werden soll
mode	-	nullterminierte Zeichenkette, die den Dateizugriffsmodus bestimmt

Datei Zugriffsmodi

Datei-Zugriff Modus-String	Bedeutung	Erklärung	Aktion, wenn Datei bereits existiert	Aktion, wenn Datei nicht existiert
"r"	read	Datei zum Lesen öffnen	lesen ab Anfang	gibt NULL zurück und setzt den Fehler
"w"	schreiben	Datei zum Schreiben erstellen	Inhalt löschen	neu erstellen
"a"	append	An eine Datei anhängen	Ende schreiben	neu erstellen
"r+"	erweitertes Lesen	Datei zum Lesen/Schreiben öffnen	lesen ab Anfang	gibt NULL zurück und setzt den Fehler
"w+"	erweitertes Schreiben	Datei zum Lesen/Schreiben erstellen	Inhalt löschen	neu erstellen
"a+"	erweitertes Anhängen	Datei zum Lesen/Schreiben öffnen	Ende schreiben	neu erstellen
Das Flag für den Dateizugriffsmodus "b" kann optional angegeben werden, um eine Datei im Binärmodus zu öffnen. Dieses Flag hat keine Auswirkungen auf POSIX-Systemen, aber unter Windows deaktiviert es beispielsweise die spezielle Behandlung von '\n' und '\x1A'. Bei Anhänge-Dateizugriffsmodi werden Daten am Ende der Datei geschrieben, unabhängig von der aktuellen Position des Dateipositionsindikators.
Das Flag für den Dateizugriffsmodus "x" kann optional an die Spezifizierer "w" oder "w+" angehängt werden. Dieses Flag bewirkt, dass die Funktion fehlschlägt, wenn die Datei existiert, anstatt sie zu überschreiben. (C++17)
Das Verhalten ist undefiniert, wenn der Modus keiner der oben aufgeführten Strings ist. Einige Implementierungen definieren zusätzliche unterstützte Modi (z. B. Windows).

Rückgabewert

Bei Erfolg wird ein Zeiger auf das Objekt zurückgegeben, das den geöffneten Dateistream steuert, wobei sowohl die EOF- als auch die Fehlerbits gelöscht sind. Der Stream ist vollständig gepuffert, es sei denn, filename bezieht sich auf ein interaktives Gerät.

Bei einem Fehler wird ein Nullzeiger zurückgegeben. POSIX schreibt vor, dass in diesem Fall errno gesetzt wird.

Hinweise

Das Format von filename ist implementierungsabhängig und bezieht sich nicht unbedingt auf eine Datei (z. B. kann es die Konsole oder ein anderes über die Dateisystem-API zugängliches Gerät sein). Auf Plattformen, die sie unterstützen, kann filename absolute oder relative Dateipfade enthalten.

Für portablen Verzeichnis- und Dateinamen siehe C++ Dateisystembibliothek oder boost.filesystem.

Beispiel

Führen Sie diesen Code aus

#include <cstdio>
#include <cstdlib>
 
int main()
{
    int is_ok = EXIT_FAILURE;
    FILE* fp = std::fopen("/tmp/test.txt", "w+");
    if (!fp)
    {
        std::perror("File opening failed");
        return is_ok;
    }
 
    int c; // Note: int, not char, required to handle EOF
    while ((c = std::fgetc(fp)) != EOF) // Standard C I/O file reading loop
        std::putchar(c);
 
    if (std::ferror(fp))
        std::puts("I/O error when reading");
    else if (std::feof(fp))
    {
        std::puts("End of file reached successfully");
        is_ok = EXIT_SUCCESS;
    }
 
    std::fclose(fp);
    return is_ok;
}

Ausgabe

End of file reached successfully

Siehe auch

fclose	schließt eine Datei (function)
fflush	synchronisiert einen Ausgabestream mit der tatsächlichen Datei (function)
freopen	öffnet einen existierenden Stream mit einem anderen Namen (function)
C-Dokumentation für fopen