_rmdir, _wrmdir

  • Artigo

Exclui um diretório.

Sintaxe

int _rmdir(
   const char *dirname
);
int _wrmdir(
   const wchar_t *dirname
);

Parâmetros

dirname
O caminho do diretório a ser removido.

Retornar valor

Cada uma dessas funções retornará 0 se o diretório for excluído com êxito. Um valor de retorno de -1 indica um erro e errno é definido como um dos seguintes valores:

errno valor Condição
ENOTEMPTY Dado caminho não é um diretório, o diretório não está vazio ou o diretório é o diretório de trabalho atual ou o diretório raiz.
ENOENT Caminho inválido.
EACCES Um programa tem um identificador aberto para o diretório.

Para obter mais informações sobre esses e outros códigos de retorno, confira errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

A função _rmdir exclui o diretório especificado por dirname. O diretório deve estar vazio e não deve ser o diretório de trabalho atual ou o diretório raiz.

A função _wrmdir é uma versão de caractere largo da função _rmdir; o argumento dirname para _wrmdir é uma cadeia de caracteres larga. Caso contrário, _wrmdir e _rmdir 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
_trmdir _rmdir _rmdir _wrmdir

Requisitos

Rotina Cabeçalho necessário
_rmdir <direct.h>
_wrmdir <direct.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

Confira o exemplo de _mkdir.

Confira também

Controle de diretório
_chdir, _wchdir
_mkdir, _wmkdir