BEZEICHNUNG

clearerr, feof, ferror - Prüfen und Rücksetzen des Datenstrom-Status

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <stdio.h>

void clearerr(FILE *datenstrom);
int feof(FILE *datenstrom);
int ferror(FILE *datenstrom);

BESCHREIBUNG

Die Funktion clearerr() löscht die Dateiende- und Fehlerkennungen für den Datenstrom, auf den datenstrom weist.

Die Funktion feof() prüft die Dateiendekennung für den Datenstrom datenstrom. feof() liefert ein Ergebnis ungleich 0, wenn die Dateiendekennung gesetzt ist. Die Dateiendekennung kann nur von der Funktion clearerr() gelöscht werden.

Die Funktion ferror() prüft die Fehlerkennung für den Datenstrom datenstrom. ferror liefert ein Ergebnis ungleich 0, wenn die Fehlerkennung gesetzt ist. Die Fehlerkennung kann nur mit der Funktion clearerr() gelöscht werden.

Für nicht sperrende Gegenstücke siehe unlocked_stdio(3).

RÜCKGABEWERT

Die Funktion feof() gibt einen von Null verschiedenen Wert zurück, falls der End-of-File-Indikator für datenstrom gesetzt ist; anderenfalls wird Null zurückgegeben.

Die Funktion ferror() gibt einen von Null verschiedenen Wert zurück, falls der Fehler-Indikator für datenstrom gesetzt ist; anderenfalls wird Null zurückgegeben.

FEHLER

Diese Funktionen sollten nicht fehlschlagen und errno nicht setzen.

ATTRIBUTE

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

STANDARDS

C11, POSIX.1-2008.

GESCHICHTE

C89, POSIX.1-2001.

ANMERKUNGEN

POSIX.1-2008 spezifiziert, dass diese Funktionen den Wert von errno nicht ändern sollen, falls datenstrom gültig ist.

WARNUNGEN

Normalerweise sollten Programme den Rückgabewert einer Eingabefunktion wie fgetc(3) lesen, bevor sie Funktionen der Familie feof(3) verwenden. Nur wenn die Funktion den Wächterwert EOF zurückliefert, ist es sinnvoll, zwischen dem Ende einer Datei und einem Fehler mit feof(3) oder ferror(3) zu unterscheiden.

SIEHE AUCH

open(2), fdopen(3), fileno(3), stdio(3), unlocked_stdio(3)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Roland Krause <Rokrause@aol.com>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>, Mario Blättermann <mario.blaettermann@gmail.com> 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.