_unlink, _wunlink
Excluir um arquivo.
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Parâmetros
- filename
Nome do arquivo a ser removido.
Valor de retorno
Cada uma dessas funções retornará 0 se com êxito. Caso contrário, a função retornará – 1 e defina errno a EACCES, o que significa que o caminho especifica um arquivo somente leitura, ou a ENOENT, que significa o arquivo ou o caminho não são encontrados ou o caminho especificado um diretório.
Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.
Comentários
A função de _unlink exclui o arquivo especificado por filename. _wunlink é uma versão de caractere longo de _unlink; o argumento filename para _wunlink é uma cadeia de caractere longo. Essas funções se comportam exatamente o contrário.
Mapeamentos da rotina de texto genérico
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_unlink |
<io.h e> stdio.h <> |
_wunlink |
<io.h ou> wchar.h <> |
Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.
Exemplo de código
Esse programa usa o _unlink para excluir 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" );
}
Entrada: crt_unlink.txt
This file will be deleted.
Saída de Exemplo
Deleted 'CRT_UNLINK.TXT'