_rtl_close

Aus RAD Studio
Wechseln zu: Navigation, Suche

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++

+