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

Retornar valor

Cada uma dessas funções retornará 0 em caso de êxito. Caso contrário, a função retorna -1 e define errno como EACCES, o que significa que o caminho especifica um arquivo somente leitura ou um diretório, ou para 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, consulte Estado global na 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'

Confira também

Manipulação de arquivos
_close
remove, _wremove