close

Nach oben zu io.h

Header-File

io.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

int close(int handle);

Beschreibung

Schließt eine Datei.

Die Funktion close schließt die mit handle verbundene Datei. handle ist ein Datei-Handle, das durch einen Aufruf von creat, creatnew, creattemp, dup, dup2, open, _rtl_creat oder _rtl_open abgerufen wurde.

Sie fügt kein Ctrl-Z-Zeichen am Ende der Datei ein. Wenn eine Datei durch ein Ctrl-Z-Zeichen abgeschlossen werden soll, muss dieses Zeichen explizit ausgegeben werden.

Rückgabewert

Bei erfolgreicher Ausführung gibt close den Wert 0 zurück.Im Fehlerfall (wenn die Ausführung fehlschlägt, weil handle kein Handle einer gültigen, geöffneten Datei enthält) gibt close den Wert -1 zurück und weist der globalen Variablen errno einen der folgenden Werte zu:

EBADF

Bad file number (Falsche Dateinummer)

Beispiel

#include <string.h>
#include <stdio.h>
#include <fcntl.h>
#include <io.h>
main()
{
  int handle;
  char buf[11] = "0123456789";
  /* Datei mit einer Größe 10 Bytes erstellen */
  handle = open("NEW.FIL", O_CREAT);
  if (handle > -1)
  {
    write(handle, buf, strlen(buf));
    close(handle);                    /* Datei schließen */
  }
  else
  {
    printf("Error opening file\n");
  }
  return 0;
}

Portabilität

POSIX	Win32	ANSI C	ANSI C++
+	+