Compartilhar via


Remover _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 retorna 0 se o arquivo é excluído com êxito.Do contrário, retornará -1 e define errno a EACCES para indicar que o caminho Especifica um arquivo somente leitura ou o arquivo está aberto, ou para ENOENT para indicar que o nome do arquivo ou caminho não foi encontrado ou o caminho Especifica um diretório.

Consulte _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre estes e outros códigos de retorno.

Comentários

O Remover função exclui o arquivo especificado por caminho._wremove é uma versão de caractere largo de _remove;  o caminho argumento para _wremove é uma seqüência de caracteres largos._wremovee _remove tenham comportamento idêntico caso contrário.Todos os identificadores para um arquivo devem ser fechados para que possa ser excluída.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H

_ Unicode & _ MBCS do arquivo não definido

_ MBCS do arquivo 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 obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.

Bibliotecas

Todas as versões da bibliotecas de 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'

Equivalência do .NET Framework

System::IO::File::Delete

Consulte também

Referência

Manipulação de arquivos

_unlink, _wunlink