remove, _wremove

Exclui um arquivo.

Sintaxe

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

Parâmetros

path
Caminho do arquivo a ser removido.

Valor retornado

Cada uma dessas funções retornará 0 se o arquivo for excluído com êxito. Caso contrário, ela retornará -1 e definirá errno como EACCES para indicar que o caminho especifica um arquivo somente leitura, especifica um diretório, ou o que arquivo está aberto ou ENOENT para indicar que o nome ou caminho do arquivo 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 remove função exclui o arquivo especificado porpath . _wremove é uma versão de caractere largo de _remove; o path argumento para _wremove é uma cadeia de caracteres largos. Caso contrário, _wremove e _remove se comportam de forma idêntica. Todos os manipuladores de um arquivo devem ser fechados para que ele possa ser excluído.

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
_tremove	remove	remove	_wremove

Requisitos

Rotina	Cabeçalho necessário
remove	<stdio.h> ou <io.h>
_wremove	<stdio.h> ou <wchar.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas

Todas as versões das bibliotecas em tempo de execução C.

Exemplo

// 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" );
}

Entrada: crt_remove.txt

This file will be deleted.

Saída de exemplo

Deleted 'CRT_REMOVE.TXT'

Confira também

Manipulação de arquivos
_unlink, _wunlink