_rmdir, _wrmdir

  • 發行項

刪除目錄。

語法

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 範例。

另請參閱

目錄控制項
_chdir, _wchdir
_mkdir, _wmkdir