BEZEICHNUNG¶

fopen, fdopen, freopen - Funktionen zum Öffnen von Datenströmen

BIBLIOTHEK¶

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT¶

#include <stdio.h>

FILE *fopen(const char *restrict pfadname, const char *restrict modus);
FILE *fdopen(int fd, const char *modus);
FILE *freopen(const char *restrict pfadname, const char *restrict modus,
              FILE *restrict datenstrom);

fdopen():

    _POSIX_C_SOURCE

BESCHREIBUNG¶

Die Funktion fopen() öffnet die Datei, deren Name die Zeichenkette ist, auf die pfadname zeigt, und erzeugt einen damit verbundenen Datenstrom.

Das Argument modus zeigt auf eine Zeichenkette, die mit einer der folgenden Sequenzen beginnt (möglicherweise gefolgt von zusätzlichen Zeichen, wie nachfolgend beschrieben):

r

eine Textdatei zum Lesen öffnen. Der Datenstrom wird auf den Dateianfang positioniert.

r+

die Textdatei zum Lesen und Schreiben öffnen. Der Datenstrom wird auf den Dateianfang positioniert.

w

die Datei auf die Länge Null kürzen oder eine Textdatei zum Schreiben erzeugen. Der Datenstrom wird auf den Dateianfang positioniert.

w+

die Datei zum Lesen und Schreiben öffnen. Die Datei wird erzeugt, wenn sie nicht existiert, ansonsten abgeschnitten. Der Datenstrom wird auf den Dateianfang positioniert.

a

zum Anhängen (Schreiben am Dateiende) öffnen. Die Datei wird erzeugt, wenn sie nicht existiert. Der Datenstrom wird auf das Dateiende positioniert.

a+

zum Lesen und Anhängen (Schreiben am Dateiende) öffnen. Die Datei wird erzeugt, wenn sie nicht existiert. Die Ausgabe wird immer am Ende der Datei angehängt. POSIX legt nicht fest, was die anfängliche Leseposition ist, wenn dieser Modus verwandt wird. Für Glibc ist die anfängliche Dateiposition zum Lesen am Dateianfang, aber für Android/BSD/MacOS ist die anfängliche Dateiposition zum Lesen am Ende der Datei.

Die Zeichenkette modus kann auch den Buchstaben »b« enthalten, entweder als ein letztes Zeichen oder zwischen den Zeichen in einem der oben beschriebenen Zeichenketten aus zwei Buchstaben. Dies ist ausschließlich aus Kompatibilitätsgründen zu ISO C so und hat keinerlei Auswirkungen; das »b« wird auf allen POSIX-konformen Systemen einschließlich Linux ignoriert. (Andere Systeme könnten Text- und Binärdateien unterschiedlich behandeln und das »b« hinzuzufügen könnte sich als klug erweisen, falls Sie E/As auf die Binärdatei ausführen und erwarten, dass Ihr Programm auf Nicht-UNIX-Umgebungen portiert wird.)

Lesen Sie die folgenden ANMERKUNGEN, um Einzelheiten über Glibc-Erweiterungen für modus zu erfahren.

Jede erstellte Datei wird den Modus S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH (0666) haben, wie er durch den Umask-Wert des Prozesses geändert wurde (siehe umask(2)).

Lese- und Schreibzugriffe können in Lese-/Schreibdatenströmen in beliebiger Reihenfolge gemischt werden. Beachten Sie, dass ANSI-C verlangt, dass zwischen einer Eingabe- und einer Ausgabeaktion eine Dateipositionierungsfunktion ausgeführt wird, außer wenn eine Eingabe auf das Dateiende traf. (Falls diese Bedingung nicht eingehalten wird, darf beim Lesen etwas anderes als das zuletzt geschriebene zurückgegeben werden.) Daher ist es ein bewährtes Verfahren (und tatsächlich manchmal unter Linux nötig) eine fseek(3)- oder fsetpos-Aktion zwischen Schreib- und Leseaktionen eines solchen Datenstroms einzuschieben. Diese Aktion könnte der Aufruf eines scheinbaren Leerbefehls (wie z.B. fseek(…, 0L, SEEK_CUR) sein, der für seinen synchroniserenden Nebeneffekt aufgerufen wird).

Eine Datei im Anhänge-Modus zu öffnen (a als erstes Zeichen von modus) hat zur Folge, dass alle nachfolgenden Schreibaktionen in diesen Datenstrom am Dateiende erscheinen, als ob ihnen folgender Aufruf vorausgegangen wäre:

fseek(stream, 0, SEEK_END);

Der dem Strom zugeordnete Dateideskriptor wird geöffnet, als ob ein Aufruf von open(2) mit den folgenden Schaltern stattgefunden hätte:

RÜCKGABEWERT¶

Bei erfolgreichem Abschluss geben fopen(), fdopen() und freopen() einen FILE-Zeiger zurück. Anderenfalls wird NULL zurückgegeben und errno dem Fehler entsprechend gesetzt.

FEHLER¶

EINVAL

Der modus für fopen(), fdopen() oder freopen() war ungültig.

Die Funktionen fopen(), fdopen() und freopen() können auch fehlschlagen und errno wegen Fehlern setzen, die für die Routine malloc(3) spezifiziert sind.

Die Funktion fopen() kann auch fehlschlagen und errno wegen Fehlern setzen, die für die Routine open(2) spezifiziert sind.

Die Funktion fdopen() kann auch fehlschlagen und errno wegen Fehlern setzen, die für die Routine fcntl(2) spezifiziert sind.

Die Funktion freopen() kann auch fehlschlagen und errno wegen Fehlern setzen, die für die Routinen open(2), fclose(3) und fflush(3) spezifiziert sind.

ATTRIBUTE¶

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS¶

fopen()

freopen()

C11, POSIX.1-2008.

fdopen()

POSIX.1-2008.

GESCHICHTE¶

fopen()

freopen()

POSIX.1-2001, C89.

fdopen()

POSIX.1-2001.

ANMERKUNGEN¶

FEHLER¶

Wenn der modus auf individuelle Schalterzeichen hin ausgewertet wird (d.h. die Zeichen, die der »ccs«-Spezifikation vorausgehen), beschränkt die Glibc-Implementierung von fopen() und freopen() die Anzahl der untersuchten Zeichen in modus auf sieben (oder, vor Glibc 2.14, auf sechs, was nicht ausreichte, um mögliche Spezifikationen wie »rb+cmxe« aufzunehmen). Die aktuelle Implementierung von fdopen() wertet höchstens fünf Zeichen in Modus aus.

SIEHE AUCH¶

open(2), fclose(3), fileno(3), fmemopen(3), fopencookie(3), open_memstream(3)

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother <krd@gulu.net>, Chris Leick <c.leick@vollbio.de>, Mario Blättermann <mario.blaettermann@gmail.com>, Dr. Tobias Quathamer <toddy@debian.org> und Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.