_unlink, _wunlink
Excluir um arquivo.
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Parâmetros
- filename
Nome do arquivo para remover.
Valor de retorno
Cada uma dessas funções retornará 0 se obtiver êxito.Caso contrário, a função retorna – 1 e define errno para EACCES, que significa que o caminho Especifica uma leitura - arquivo somente ou para ENOENT, que significa que o arquivo ou caminho não for encontrado ou o caminho especificado um diretório.
See _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre esses e outros códigos retorno.
Comentários
The _unlink função exclui o arquivo especificado por filename. _wunlink é uma versão de caractere largo da _unlink; o filename argumento para _wunlink é uma seqüência de caracteres largos. Essas funções se comportam exatamente caso contrário.
Mapeamentos de rotina de texto genérica
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 obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Exemplo de código
Esse programa usa _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'