ディレクトリを削除します。
構文
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 の例を参照してください。