_unlink
, _wunlink
Exclui um arquivo.
Sintaxe
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Parâmetros
filename
Nome do arquivo a ser removido.
Valor retornado
Cada uma dessas funções retornará 0 em caso de êxito. Caso contrário, a função retornará -1 e será definida errno
como EACCES
, o que significa que o caminho especifica um arquivo somente leitura ou um diretório, ou como ENOENT
, o que significa que o arquivo ou caminho não foi encontrado.
Para obter mais informações sobre códigos de retorno, confira errno
, _doserrno
, _sys_errlist
e _sys_nerr
.
Comentários
A função _unlink
exclui o arquivo especificado por filename
. A função _wunlink
é uma versão de caractere largo da função _unlink
; o argumento filename
para _wunlink
é uma cadeia de caracteres larga. Caso contrário, essas funções se comportam de forma idêntica.
Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.
Mapeamentos de rotina de texto genérico
Rotina TCHAR.H | _UNICODE e _MBCS não definidos |
_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 sobre compatibilidade, consulte Compatibilidade.
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'