_rmdir, _wrmdir
Elimina un directorio.
Sintaxis
int _rmdir(
const char *dirname
);
int _wrmdir(
const wchar_t *dirname
);
Parámetros
dirname
Ruta de acceso del directorio que se va a quitar.
Valor devuelto
Cada una de estas funciones devuelve 0 si el directorio se elimina correctamente. Un valor devuelto de -1 indica un error y errno se establece en uno de los siguientes valores:
Valor de errno |
Condición |
|---|---|
ENOTEMPTY |
La ruta de acceso dada no es un directorio, el directorio no está vacío o el directorio es el directorio de trabajo actual o el directorio raíz. |
ENOENT |
La ruta de acceso no es válida. |
EACCES |
Un programa tiene un identificador abierto en el directorio. |
Para obtener más información sobre estos y otros códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.
Comentarios
La función _rmdir elimina el directorio especificado por dirname. El directorio debe estar vacío y no debe ser el directorio de trabajo actual ni el directorio raíz.
_wrmdir es una versión con caracteres anchos de _rmdir; el argumento dirname para _wrmdir es una cadena de caracteres anchos. Por lo demás,_wrmdir y _rmdir se comportan de forma idéntica.
De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.
Asignaciones de rutinas de texto genérico
| Rutina Tchar.h | _UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_trmdir |
_rmdir |
_rmdir |
_wrmdir |
Requisitos
| Routine | Encabezado necesario |
|---|---|
_rmdir |
<direct.h> |
_wrmdir |
<direct.h> o <wchar.h> |
Para obtener más información sobre compatibilidad, consulte Compatibilidad.
Bibliotecas
Todas las versiones de las bibliotecas en tiempo de ejecución de C.
Ejemplo
Vea el ejemplo de _mkdir.