_rmdir、_wrmdir
更新 : 2007 年 11 月
ディレクトリを削除します。
int _rmdir(
const char *dirname
);
int _wrmdir(
const wchar_t *dirname
);
パラメータ
- dirname
削除するディレクトリのパス。
戻り値
ディレクトリが正常に削除されると 0 を返します。エラーが発生した場合は -1 を返し、変数 errno に次のいずれかの値を設定します。
ENOTEMPTY
指定されたパスがディレクトリではないか、ディレクトリが空ではないか、現在の作業ディレクトリまたはルート ディレクトリです。ENOENT
パスが無効です。EACCES
プログラムでディレクトリへのハンドルを開いています。
リターン コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
_rmdir 関数は、dirname で指定したディレクトリを削除します。削除するディレクトリは空のディレクトリだけです。また、現在の作業ディレクトリやルート ディレクトリは削除できません。
_wrmdir は _rmdir のワイド文字バージョンです。_wrmdir の dirname 引数はワイド文字列です。引数の指定以外では、_wrmdir と _rmdir の動作は同じです。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_trmdir |
_rmdir |
_rmdir |
_wrmdir |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_rmdir |
<direct.h> |
_wrmdir |
<direct.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
使用例
「_mkdir」の例を参照してください。