fopen() ist in der stdio definiert, die in C über stdio.h, bzw in C++ über cstdio eingebunden wird.

fopen() wird dazu verwendet, einen Stream bzw. eine Datei zu öffnen. Sie nimmt dazu 2 Parameter. Der Stream bzw. die Datei kann auf unterschiedliche Arten geöffnet werden.

#include <stdio.h>
FILE * fopen( char const * filename, char const * mode );

filename: Dateiname (optional inklusive Pfad) der zu öffnenden Datei.
mode: Modus, wie die Datei zu öffnen ist.

Return Value: Zeiger auf geöffneten Stream oder NULL im Falle eines Fehlers.

Je nach Modus befindet sich die Schreib-/Lese-Position am Anfang der Datei, wenn angefügt werden soll befindet sie sich direkt am Ende der Datei, so dass am Ende der Datei geschrieben werden kann. Die Position kann nach dem Öffnen mit fseek() beliebig versetzt werden.

Per Default werden Dateien zeilenorientiert geöffnet. Hängt man dem mode zusätzlich ein „b“ an (z.B. „r+b“), so wird die Datei im Binärmodus geöffnet.

Ein oft vorkommender Fehler ist, dass die Datei, die zum Lesen geöffnet werden soll, nicht existiert bzw. der Pfad zu ihr falsch angegeben ist. Auch kann es passieren, dass die erforderlichen Rechte um eine Datei zu öffnen nicht vorhanden sind. In beiden Fällen resultiert das in der Rückgabe eines NULL-Pointers.

Ein unangenehmer Fehler kann auftreten, wenn man eine existierende Datei zum Schreiben („w“ oder „w+“) öffnet. Dabei wird die Schreibposition an den Anfang der Datei gesetzt. Schreibt man nun in die Datei, so wird der vorherige Inhalt überschrieben.

Fehler können auch auftreten, wenn eine Datei nach der Benutzung nicht wieder ordnungsgemäß geschlossen wird. Eine Datei schließt man mit fclose().

#include <stdio.h>
#include <stdlib.h>
 
int main (void)
{
  FILE *file = fopen("testfile.txt", "r");
  // (...)
  fclose(file);
  return EXIT_SUCCESS;
}

stdio: fclose()