remove, _wremove
Löschen einer Datei
int remove(
const char *path
);
int _wremove(
const wchar_t *path
);
Parameter
- path
Pfad der zu entfernende Datei.
Rückgabewert
Jede dieser Funktionen gibt 0 zurück, wenn die Datei erfolgreich gelöscht wird. Andernfalls wird -1 zurückgegeben und errno fest, auf das EACCES, um anzugeben jedes, ist, dass der Pfad eine schreibgeschützte Datei angibt, oder die Datei geöffnet ist, oder auf ENOENT festzulegen, ob der Dateiname oder der Pfad nicht gefunden wurden, oder dass der Pfad einem Verzeichnis angibt.
Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Die Entfernen-Funktion wird die Datei, die vom Pfad angegeben. _wremove ist eine Breitzeichen-Version von _remove; das Pfad argument zu _wremove ist eine Zeichenfolge mit Breitzeichen. _wremove und _remove identisch verhalten sich andernfalls. Alle Handles zu einer Datei muss geschlossen werden, bevor sie gelöscht werden kann.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
---|---|---|---|
_tremove |
remove |
remove |
_wremove |
Anforderungen
Routine |
Erforderlicher Header |
---|---|
remove |
<stdio.h oder> io.h <> |
_wremove |
<stdio.h> oder <wchar.h> |
Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken
Alle Versionen C-Laufzeitbibliotheken.
Beispiel
// crt_remove.c
/* This program uses remove to delete crt_remove.txt */
#include <stdio.h>
int main( void )
{
if( remove( "crt_remove.txt" ) == -1 )
perror( "Could not delete 'CRT_REMOVE.TXT'" );
else
printf( "Deleted 'CRT_REMOVE.TXT'\n" );
}
Eingabe: crt_remove.txt
This file will be deleted.
Beispielausgabe
Deleted 'CRT_REMOVE.TXT'