_rmdir, _wrmdir

ディレクトリを削除します。

構文

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

パラメーター

dirname
削除されるディレクトリのパス。

戻り値

ディレクトリが正常に削除された場合、これらの関数はそれぞれ 0 を返します。 戻り値 -1 はエラーを示し、 errno 次のいずれかの値に設定されます。

errno 状態
ENOTEMPTY 指定されたパスがディレクトリではないか、ディレクトリが空ではないか、ディレクトリが現在の作業ディレクトリまたはルート ディレクトリです。
ENOENT パスが無効です。
EACCES プログラムに、ディレクトリに対して開いているハンドルがあります。

これらのリターン コードとその他のリターン コードについては、「errno_doserrno_sys_errlist_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>

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

C ランタイム ライブラリのすべてのバージョン。

_mkdir の例を参照してください。

関連項目

ディレクトリ コントロール
_chdir, _wchdir
_mkdir, _wmkdir