remove, _wremove
Excluir um arquivo.
int remove(
const char *path
);
int _wremove(
const wchar_t *path
);
Parâmetros
- caminho
Caminho do arquivo a ser removido.
Valor de retorno
Cada uma dessas funções retornará 0 se o arquivo é excluído com êxito. Caso contrário, retorna -1 e define um errno ou a EACCES para indicar que o caminho especifica um arquivo somente leitura ou o arquivo está aberto, ou a ENOENT para indicar que o nome de arquivo ou o caminho não foram encontrados ou se o caminho especifica um diretório.
Consulte _doserrno, errno, _sys_errlist, e _sys_nerr para obter mais informações sobre esses e outros códigos de retorno.
Comentários
A função de remove exclui o arquivo especificado pelo caminho. _wremove é uma versão de ampla caractere de _remove; o argumento de caminho a _wremove é uma cadeia de caracteres de ampla caractere. _wremove e _remove se comportam idêntica de outra forma. Todas as alças para um arquivo devem ser fechadas antes que possa ser excluído.
Mapeamentos da rotina de texto genérico
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_tremove |
remover |
remover |
_wremove |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
remover |
<stdio.h ou> io.h <> |
_wremove |
<stdio.h> ou <wchar.h> |
Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.
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'