_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
の例を参照してください。