_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'

Vedi anche

Gestione dei file
_close
remove, _wremove