_rtl_close
Nach oben zu io.h - Index
Header-Datei
io.h
Kategorie
Eingabe-/Ausgaberoutinen
Prototyp
int _rtl_close(int handle);
Beschreibung
Schließt eine Datei.
Anmerkung: Diese Funktion ersetzt die Funktion _close, die veraltet ist.
Die Funktion _rtl_close schließt die handle zugeordnete Datei. handle ist ein Datei-Handle, das durch einen Aufruf von creat, creatnew, creattemp, dup, dup2, open, _rtl_creat oder _rtl_open abgerufen wird.
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 die Funktion _rtl_close 0 zurück.
Im Fehlerfall (wenn die Ausführung fehlschlägt, weil handle kein Handle einer gültigen, geöffneten Datei enthält) gibt _rtl_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>
int main(void)
{
int handle;
char msg[] = "Hello world";
if ((handle = _rtl_open("TEST.$$$", O_RDWR)) == -1)
{
perror("Error:");
return 1;
}
_rtl_write(handle, msg, strlen(msg));
_rtl_close(handle);
return 0;
}
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ |
---|---|---|---|
+ |