ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

copyfile

ファイルまたはフォルダーをコピーする

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

構文

copyfile source
copyfile source destination
copyfile source destination f
status = copyfile(___)
[status,msg] = copyfile(___)
[status,msg,msgID] = copyfile(___)

説明

copyfile source は、source ファイルまたはフォルダーを現在のフォルダーにコピーします。copyfile 操作が正常に完了した後、新規ファイルのタイムスタンプは、source のタイムスタンプと同じになります。

例

copyfile source destination は source をファイルまたはフォルダーの destination にコピーします。

  • source がファイルの場合、destination にはファイルまたはフォルダーを指定できます。

  • source がフォルダーの場合、destination はフォルダーでなければなりません。

  • source にフォルダーまたは複数のファイルが指定され、かつ destination が存在しない場合、copyfile は destination を作成しようとします。

例

copyfile source destination f は、destination が書き込み不可の場合でも、source を destination にコピーします。destination の読み取り/書き込み属性の状態は変化しません。

例

status = copyfile(___) は指定されたファイルまたはフォルダーをコピーし、操作が正常に完了した場合はステータス 1 を返します。それ以外の場合、copyfile は 0 を返します。この構文では、前述の構文の入力引数を任意に組み合わせて使用できます。

例

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

例

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

例

すべて折りたたむ

ライブ スクリプトを開く

現在のフォルダーにある myfile1.m をサブフォルダー myFolder にコピーします。

mkdir myFolder
copyfile myfile1.m myFolder
ライブ スクリプトを開く

現在のフォルダー内に myfile1.m のコピーを作成し、myfile2.m という名前を割り当てます。

copyfile myfile1.m myfile2.m
ライブ スクリプトを開く

newFolder がまだ存在していないときに、名前が my で始まるファイルとサブフォルダーを現在のフォルダーから newFolder フォルダーにコピーします。

copyfile my* newFolder
ライブ スクリプトを開く

myfile1.m ファイルを現在のフォルダーから読み取り専用の restricted フォルダーにコピーします。

読み取り専用の restricted フォルダーを作成します。

mkdir restricted
fileattrib restricted -w

ファイルをコピーして、myfile1.m というファイル名に変更します。ステータスが 0 の場合、コピーは失敗しています。

status = copyfile('myfile1.m', 'restricted');
status
status = logical
   0

コピー先フォルダーの読み取り専用ステータスをオーバーライドする 'f' オプションを使用して、myfile1.m ファイルをコピーします。ステータスが 1 で message と messageId が空である場合は、コピーが正常に完了したことを示します。

[status,message,messageId] = copyfile('myfile1.m', 'restricted', 'f');
status
status = logical
   1


message
message =

  0x0 empty char array

messageId
messageId =

  0x0 empty char array

入力引数

すべて折りたたむ

コピー元のファイルまたはフォルダー。文字ベクトルまたは string スカラーとして指定します。source には絶対パスまたは相対パスを指定できます。複数のファイルまたはフォルダーをコピーするには、ワイルドカード (*) を使用します。

メモ

source が string の場合は、すべての入力をかっこで囲みます。たとえば、movefile("myfile.m","newfolder") のようになります。

コピー先のファイルまたはフォルダー。文字ベクトルまたは string スカラーとして指定します。destination は絶対パスまたは相対パスにできますが、ワイルドカードは使用できません。

メモ

destination が string の場合は、すべての入力をかっこで囲みます。たとえば、movefile("myfile.m","newfolder") のようになります。

出力引数

すべて折りたたむ

コピーのステータス。ファイルまたはフォルダーの移動の試行が正常に完了したかどうかを表し、0 または 1 として返されます。試行が正常に完了していれば、status の値は 1 になります。それ以外の場合、この値は 0 です。

データ型: logical

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

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

参考

| | | | |

トピック

R2006a より前に導入

MATLAB ドキュメンテーション
サポート
MATLABで始めるディープラーニング

MATLABで始めるディープラーニング

ebookをダウンロードする