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

Requisitos

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