_unlink, _wunlink
Löschen einer Datei
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Parameter
- filename
Name der zu entfernende Datei.
Rückgabewert
Jede dieser Funktionen gibt 0 zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird die Funktion - 1 zurück und legt errno auf EACCES fest, was bedeutet, dass der Pfad eine schreibgeschützte Datei angibt oder ENOENT, die besagt, die Datei oder der Pfad nicht gefunden wird, oder der Pfad ein Verzeichnis angegeben.
Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Die _unlink-Funktion wird die Datei, die von filename angegeben wird. _wunlink ist eine Breitzeichenversion von _unlink. Das filename-Argument für _wunlink ist eine Breitzeichenfolge. Anderenfalls verhalten sich diese Funktionen identisch.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_unlink |
<io.h und> stdio.h <> |
_wunlink |
<io.h oder> wchar.h <> |
Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Codebeispiel
Dieses Programm verwendet _unlink, um CRT_UNLINK.TXT zu löschen.
// crt_unlink.c
#include <stdio.h>
int main( void )
{
if( _unlink( "crt_unlink.txt" ) == -1 )
perror( "Could not delete 'CRT_UNLINK.TXT'" );
else
printf( "Deleted 'CRT_UNLINK.TXT'\n" );
}
Eingabe: crt_unlink.txt
This file will be deleted.
Beispielausgabe
Deleted 'CRT_UNLINK.TXT'