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 |