remove, _wremove

Nach oben zu stdio.h - Index

Header-Datei

stdio.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

int remove(const char *filename);

int _wremove(const wchar_t *filename);

Beschreibung

Entfernt eine Datei.

remove löscht die mit filename angegebene Datei. Die Funktion ist ein Makro, das seinen Aufruf einfach in einen Aufruf von unlink umwandelt. Ist Ihre Datei geöffnet, dann achten Sie darauf, sie zu schließen, bevor sie gelöscht wird.

Der String filename kann eine vollständige Pfadangabe enthalten.

Rückgabewert

Bei erfolgreichem Abschluss gibt remove 0 zurück. Bei einem Fehler wird -1 zurückgegeben und die globale Variable errno auf einen der folgenden Werte gesetzt:

EACCES	Permission denied (Zugriff verweigert)
ENOENT	No such file or directory (Datei oder Verzeichnis nicht gefunden)

Beispiel

 #include <stdio.h>
 int main(void)
 {
     char file[80];
     /* Zur Eingabe des Namens der zu löschenden Datei auffordern */
     printf("File to delete: ");
     gets(file);
     /* Datei löschen */
     if (remove(file) == 0)
        printf("Removed %s.\n",file);
     else
        perror("remove");
     return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
remove	+	+	+	+
_wremove		Nur NT