_unlink, _wunlink
Consente di eliminare un file.
Sintassi
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Parametri
filename
Nome del file da rimuovere.
Valore restituito
Ognuna di queste funzioni restituisce 0 in caso di esito positivo. In caso contrario, la funzione restituisce -1 e imposta errno su EACCES, il che significa che il percorso specifica un file di sola lettura o una directory o su ENOENT, il che significa che il file o il percorso non viene trovato.
Per altre informazioni sui codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.
Osservazioni:
La funzione _unlink elimina il file specificato da filename. _wunlink è una versione a caratteri wide di _unlink; l'argomento filename in _wunlink è una stringa di caratteri wide. A parte ciò, queste funzioni si comportano in modo identico.
Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.
Mapping di routine di testo generico
| Routine TCHAR.H | _UNICODE e _MBCS non definito |
_MBCS definito |
_UNICODE definito |
|---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Requisiti
| Ciclo | Intestazione obbligatoria |
|---|---|
_unlink |
<io.h> e <stdio.h> |
_wunlink |
<io.h> o <wchar.h> |
Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).
Esempio di codice
Questo programma usare _unlink per eliminare CRT_UNLINK. TXT.
// 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" );
}
Input: crt_unlink.txt
This file will be deleted.
Output di esempio
Deleted 'CRT_UNLINK.TXT'