刪除目錄。
語法
int _rmdir(
const char *dirname
);
int _wrmdir(
const wchar_t *dirname
);
參數
dirname
要移除之目錄的路徑。
傳回值
如果已成功刪除目錄，所有這些函式都會傳回 0。 -1 的傳回值表示錯誤，並 errno 設定為下列其中一個值：
errno 值 |
Condition |
|---|---|
ENOTEMPTY |
指定的路徑不是目錄、目錄不是空的，或目錄是目前的工作目錄或根目錄。 |
ENOENT |
路徑無效。 |
EACCES |
程式已有目錄的開啟控制代碼。 |
如需這些傳回碼和其他傳回碼的詳細資訊，請參閱errno、 _sys_errlist_doserrno和 _sys_nerr。
備註
_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 的範例。