rmdir

フォルダーの削除

ページ内をすべて折りたたむ

構文

rmdir folderName
rmdir folderName s
rmdir(folderName,ResolveSymbolicLinks=tf)
status = rmdir(___)
[status,msg] = rmdir(___)
[status,msg,msgID] = rmdir(___)

説明

rmdir folderName は folderName フォルダーを現在のフォルダーから削除します。folderName は空でなければなりません。操作が正常に完了しない場合、MATLAB® はコマンド ウィンドウにエラーをスローします。

例

また、rmdir folderName s は、書き込み権限にかかわりなく、folderName 内のすべてのサブフォルダーおよびファイルの削除を試行します。読み取り専用ファイルの結果は、オペレーティング システムに従います。

例

rmdir(folderName,ResolveSymbolicLinks=tf) は、シンボリック リンクまたはそのターゲットを削除するかどうかを指定します。 (R2024b 以降)

status = rmdir(___) は指定したフォルダーを削除し、操作が正常に完了すればステータスとして 1 を返します。それ以外の場合、rmdir は 0 を返します。警告とエラーはコマンド ウィンドウにはスローされません。この構文では、前述の構文の入力引数を任意に組み合わせて使用できます。

例

[status,msg] = rmdir(___) は、発生した警告またはエラーに関するメッセージ テキストも返します。

例

[status,msg,msgID] = rmdir(___) は、発生した警告またはエラーに関するメッセージ ID も返します。

例

例

すべて折りたたむ

ライブ スクリプトを開く

現在のフォルダーに myproject および myproject/myfiles フォルダーを作成してから、削除します。

mkdir myproject
mkdir myproject/myfiles

rmdir myproject/myfiles
rmdir myproject
ライブ スクリプトを開く

ファイル myfile1.m および myfile2.m を含むフォルダー myfiles を削除します。

フォルダー myfiles を作成し、ファイル myfile1.m および myfile2.m を現在のフォルダーからこの新しいフォルダーに移動します。

mkdir myfiles
movefile myfile1.m myfiles
movefile myfile2.m myfiles

rmdir を使用してフォルダー myfiles の削除を試行します。myfiles は空ではないため操作は失敗し、ステータス 0 と、操作が失敗した理由の詳細を示すエラー メッセージが返されます。

[status, message, messageid] = rmdir('myfiles')
status = logical
   0


message = 
''myfiles' was not removed. The directory must be empty before removing.'

messageid = 
'MATLAB:RMDIR:DirectoryNotRemoved'

次に、's' フラグを使用してフォルダー myfiles を削除します。ステータスが 1 で message と messageid が空の場合、操作は成功しています。

[status, message, messageid] = rmdir('myfiles', 's')
status = logical
   1


message =

  0×0 empty char array


messageid =

  0×0 empty char array

入力引数

すべて折りたたむ

削除するフォルダーの名前。文字ベクトルまたは string スカラーとして指定します。folderName は絶対パスまたは相対パスとして指定します。

R2024b 以降

シンボリック リンクのターゲットの削除。数値または logical 0 (false) または 1 (true) として指定します。tf が true の場合、rmdir はシンボリック リンクのターゲットを削除します。シンボリック リンク自体は残りますが、削除されたフォルダーへのリンクとなります。tf が false の場合、rmdir はシンボリック リンク自体を削除します。

出力引数

すべて折りたたむ

フォルダーの削除の試行が成功したかどうかを示すフォルダーのステータス。0 または 1 として返されます。操作が正常に完了した場合、status は 1 です。それ以外の場合、status は 0 です。

データ型: logical

エラー メッセージ。文字ベクトルとして返されます。エラーまたは警告が発生した場合、msg にはエラーまたは警告のメッセージ テキストが格納されます。それ以外の場合、msg は空 ('') です。

エラー メッセージ識別子。文字ベクトルとして返されます。エラーまたは警告が発生した場合、msgID にはエラーまたは警告のメッセージ ID が格納されます。それ以外の場合、msgID は空 ('') です。

ヒント

  • ローカル フォルダーの場合と同様に、rmdir では、s フラグを指定しない限り空でない仮想フォルダーは削除できません。ファイル サービスによっては、空のフォルダーがサポートされていない場合があります。これらのサービスでは、rmdir でフォルダーを削除してそれらの親フォルダーが空になると、親フォルダーも削除されます。詳細については、リモート データの操作を参照してください。

代替機能

[ファイル] パネルで、フォルダー名を右クリックして、コンテキスト メニューから [削除] を選択します。[ファイル] パネルを開くには、filebrowser コマンドを使用します。

拡張機能

すべて展開する

スレッドベースの環境
MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

バージョン履歴

R2006a より前に導入

すべて展開する

参考

| | | | |