_unlink, _wunlink

Löschen Sie eine Datei.

Syntax

int _unlink(
   const char *filename
);
int _wunlink(
   const wchar_t *filename
);

Parameter

filename
Name der zu entfernenden Datei.

Rückgabewert

Jede dieser Funktionen gibt bei Erfolg 0 zurück. Andernfalls gibt die Funktion -1 zurück und legt sie errnoEACCESauf fest, was bedeutet, dass der Pfad eine schreibgeschützte Datei oder ein Verzeichnis oder ein ENOENTVerzeichnis angibt, was bedeutet, dass die Datei oder der Pfad nicht gefunden wird.

Weitere Informationen zu Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Hinweise

Die _unlink-Funktion löscht die von filename angegebene Datei. _wunlink ist eine Breitzeichenversion von _unlink. Das filename -Argument für _wunlink ist eine Breitzeichenfolge. Anderenfalls verhalten sich diese Funktionen identisch.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

TCHAR.H-Routine	_UNICODE und _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>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

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'

Siehe auch

Dateiverarbeitung
_close
remove, _wremove