_rmdir, _wrmdir

Удаляет каталог.

Синтаксис

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

Параметры

dirname
Путь к каталогу, который следует удалить.

Возвращаемое значение

Каждая из этих функций возвращает 0, если каталог был успешно удален. Возвращаемое значение -1 указывает на ошибку и errno имеет одно из следующих значений:

Значение errno Condition
ENOTEMPTY Указанный путь не является каталогом, каталог не пуст, либо каталог является текущим рабочим или корневым каталогом.
ENOENT Недопустимый путь.
EACCES Программа имеет открытый дескриптор каталога.

Дополнительные сведения об этих и других кодах возврата см. в разделе errno, _doserrnoи _sys_nerr_sys_errlist.

Замечания

Функция _rmdir удаляет каталог, указанный в параметре dirname. Каталог должен быть пустым и не должен являться текущим рабочим или корневым каталогом.

_wrmdir — это версия _rmdirс расширенными символами; аргумент dirname для _wrmdir — строка расширенных символов. Поведение_wrmdir и _rmdir идентично в противном случае.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Подпрограмма Tchar.h _UNICODE и _MBCS не определен _MBCS Определенные _UNICODE Определенные
_trmdir _rmdir _rmdir _wrmdir

Требования

Маршрут Обязательный заголовок
_rmdir <direct.h>
_wrmdir <direct.h> или <wchar.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Библиотеки

Все версии библиотек времени выполнения языка C.

Пример

Пример см. в примере _mkdir.

См. также

Элемент управления каталогом
_chdir, _wchdir
_mkdir, _wmkdir

  • Last updated on