remove, _wremove

Consente di eliminare un file.

Sintassi

int remove(
   const char *path
);
int _wremove(
   const wchar_t *path
);

Parametri

path
Percorso del file da rimuovere.

Valore restituito

Ognuna di queste funzioni restituisce 0 se il file viene eliminato correttamente. In caso contrario, restituisce -1 e imposta errno su EACCES per indicare che il percorso specifica un file di sola lettura, specifica una directory o il file è aperto oppure per ENOENT indicare che il nome file o il percorso non è stato trovato.

Per altre informazioni sui codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

La remove funzione elimina il file specificato dapath . _wremove è una versione a caratteri wide di _remove. L'argomento path a _wremove è una stringa di caratteri wide. In caso contrario,_wremove e _remove si comportano in modo identico. Tutti gli handle in un file devono essere chiusi prima che possano essere eliminati.

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

TCHAR.H routine	_UNICODE e _MBCS non definito	_MBCS definito	_UNICODE definito
_tremove	remove	remove	_wremove

Requisiti

Ciclo	Intestazione obbligatoria
remove	<stdio.h> oppure <io.h>
_wremove	<stdio.h> oppure <wchar.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie

Tutte le versioni delle librerie di runtime C.

Esempio

// crt_remove.c
/* This program uses remove to delete crt_remove.txt */

#include <stdio.h>

int main( void )
{
   if( remove( "crt_remove.txt" ) == -1 )
      perror( "Could not delete 'CRT_REMOVE.TXT'" );
   else
      printf( "Deleted 'CRT_REMOVE.TXT'\n" );
}

Immissione: crt_remove.txt

This file will be deleted.

Output di esempio

Deleted 'CRT_REMOVE.TXT'

Vedi anche

Gestione dei file
_unlink, _wunlink