mkdir

フォルダーを新規作成する

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

構文

mkdir folderName
mkdir parentFolder folderName
status = mkdir(___)
[status,msg] = mkdir(___)
[status,msg,msgID] = mkdir(___)

説明

mkdir folderName はフォルダー folderName を作成します。folderName が存在する場合、MATLAB® で警告が表示されます。操作が正常に完了しない場合、mkdir はコマンド ウィンドウにエラーをスローします。

例

mkdir parentFolder folderName は parentFolder に folderName を作成します。parentFolder が存在しない場合は、MATLAB は作成を試みます。

例

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

例

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

例

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

例

例

すべて折りたたむ

ライブ スクリプトを開く

現在のフォルダーにフォルダー newdir を作成します。

 mkdir newdir
ライブ スクリプトを開く

フォルダー testdata に newfolder というフォルダーを作成します。相対パスを使用して、newFolder が現在のフォルダーと同レベルになるようにします。

mkdir ../testdata newFolder
ライブ スクリプトを開く

同じフォルダーを 2 回作成し、それぞれの試行後に操作のステータスを検証します。

フォルダー newFolder を作成します。操作が成功するとステータス 1 が返され、エラー メッセージや警告メッセージは表示されません。

[status, msg, msgID] = mkdir('newFolder')
status = logical
   1


msg =

  0×0 empty char array


msgID =

  0×0 empty char array

もう一度フォルダー newFolder を作成します。操作は今回も成功し、ステータス 1 が返されます。警告メッセージとメッセージ ID により、フォルダーが既に存在することが示されます。

[status, msg, msgID] = mkdir('newFolder')
status = logical
   1


msg = 
'Directory already exists.'

msgID = 
'MATLAB:MKDIR:DirectoryExists'

入力引数

すべて折りたたむ

フォルダー名。文字ベクトルまたは string スカラーとして指定します。親フォルダーが指定されていなければ、folderName は絶対パスまたは相対パスとして指定できます。親フォルダーを指定した場合、folderName は親フォルダーを基準とする相対パスでなければなりません。

存在しないフォルダーを 1 つ以上含むパスが folderName に含まれていると、MATLAB はその存在しないフォルダーの作成を試みます。たとえば、myFolder\folder1\folder2\targetFolder について、folder1 が存在しなければ、MATLAB は folder1 を作成し、folder1 の内部に folder2、folder2 の内部に targetFolder を作成します。

データ型: char | string

新しいフォルダーの親フォルダー。文字ベクトルまたは string スカラーとして指定します。parentFolder は絶対パスまたは相対パスとして指定します。parentFolder が存在しない場合は、MATLAB は作成を試みます。

データ型: char | string

出力引数

すべて折りたたむ

フォルダー作成ステータス。フォルダー作成の試行が成功したかどうかを表し、0 または 1 として返されます。フォルダー作成の試行が作成した場合、またはフォルダーが既に存在している場合、status の値は 1 です。それ以外の場合、この値は 0 です。

データ型: logical

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

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

ヒント

  • mkdir を使用してリモートの場所にフォルダーを作成できます。リモートの場所に書き込むには、folderName または parentName に次の形式の Uniform Resource Locator (URL) として指定されたファイルの絶対パスを含めなければなりません。

    schema_name://path_to_file/folderName

    または

    schema_name://path_to_file/parentName

    schema_name と path_to_file の間に 1 つまたは 3 つの "スラッシュ" (/) 文字を使用しても有効です。以下に例を示します。

    schema_name:/path_to_file/folderName

    または

    schema_name:///path_to_file/parentName

    リモートの場所に基づいて、schema_name には次の表の値のいずれかを指定できます。

    ファイル システムschema_name
    Amazon S3™s3
    Windows Azure® Blob Storagewasb, wasbs
    HDFS™hdfs

    使用しているファイル システムで空のフォルダーがサポートされていない場合、そのサービスで mkdir を使用しようとするとエラーがスローされます。詳細については、リモート データの操作を参照してください。

拡張機能

すべて展開する

バージョン履歴

R2006a より前に導入

すべて展開する

参考

| | | |

トピック