_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