CKTIS / C
fclose — C23-Datenstromfunktion
`fclose(stream)` aus `<stdio.h>` leert den angegebenen Datenstrom, liefert ungeschriebene Daten an die Hostumgebung, verwirft ungelesene Eingabe, schließt die zugehörige Datei und trennt das `FILE`-Objekt. Bei Erfolg wird null, bei Fehler `EOF` geliefert.
Version: C23
Syntax
int fclose(FILE *stream);fclose(stream) aus <stdio.h> leert den angegebenen Datenstrom, liefert ungeschriebene Daten an die Hostumgebung, verwirft ungelesene Eingabe, schließt die zugehörige Datei und trennt das FILE-Objekt. Bei Erfolg wird null, bei Fehler EOF geliefert.
Das Beispiel erzeugt eine tmpfile(), schreibt die fünf Bytes hello, ermittelt die Position mit ftell und ruft dann fclose auf. 5 1 bestätigt die logische Größe vor dem Schließen und einen Nullstatus; dabei wird die temporäre Datei entfernt.
Auch wenn fclose fehlschlägt, ist der Datenstrom getrennt und darf nicht erneut geleert, geschlossen oder anderweitig benutzt werden. Status prüfen, denn ein Fehler beim Schreiben gepufferter Ausgabe kann erst beim Schließen sichtbar werden. stream muss einen offenen Datenstrom bezeichnen; danach ist der Zeiger kein gültiges Handle mehr.
Beispiele
#include <stdio.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputs("hello", stream) == EOF) { fclose(stream); return 1; }
long position = ftell(stream);
if (position < 0) { fclose(stream); return 1; }
int closed = fclose(stream);
printf("%ld %d\n", position, closed == 0);
return closed == 0 ? 0 : 1;
}
Ergebnis
5 1
Das Beispiel erzeugt eine `tmpfile()`, schreibt die fünf Bytes `hello`, ermittelt die Position mit `ftell` und ruft dann `fclose` auf. `5 1` bestätigt die logische Größe vor dem Schließen und einen Nullstatus; dabei wird die temporäre Datei entfernt.