_unlink, _wunlink
Eliminare un file.
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 se ha esito positivo. In caso contrario, la funzione restituisce -1 ed imposta errno a EACCES, ovvero il percorso indica un file di sola lettura, o a ENOENT, ovvero il file o il percorso non vengono trovati o il percorso specificato è una directory.
Vedere _doserrno, errno, _sys_errlist, e _sys_nerr per ulteriori informazioni su questi, e altri, codici restituiti.
Note
La funzione _unlink elimina il file specificato da filename. _wunlink è una versione a caratteri estesi di _unlink; l'argomento filename in _wunlink è una stringa di caratteri estesi. Altrimenti queste funzioni si comportano in modo identico.
Mapping di routine di testo generico
Routine TCHAR.H |
_UNICODE & _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
|---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_unlink |
<io.h> e stdio.h <> |
_wunlink |
<io.h> o <wchar.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.
Esempio di codice
Questo programma utilizza _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.
Esempio di output
Deleted 'CRT_UNLINK.TXT'