4D Doc Center : COPY DOCUMENT

4D v13.4

COPY DOCUMENT


COPY DOCUMENT ( sourceName ; destinationName {; *} )

引数	型	説明
sourceName	文字	コピーするファイルやフォルダーのパス名
destinationName	文字	ファイルやフォルダーコピーの配置先名またはパス名
*	演算子	存在する場合、既存のドキュメントを上書きする

COPY DOCUMENTコマンドを使用して、sourceNameによって指定されたファイルやフォルダーをdestinationNameによって指定された場所にコピーします。

ファイルのコピー
この場合sourceName引数にはボリュームのルートから始まる完全なファイルパス名を渡します。
destinationName引数には複数のタイプで場所を指定できます:
- ボリュームのルートから始まる完全なファイルパス名。ファイルはこの場所にコピーされます。
- ファイル名または相対的なファイルパス名。ファイルはデータベースフォルダー内にコピーされます。サブフォルダーはコマンド実行前に存在していなければなりません。
- データベースフォルダーから相対的な完全フォルダーパス名またはパス名。destinationNameはプラットフォームに応じたフォルダー区切り文字で終わっていなければなりません。ファイルは指定したフォルダーにコピーされます。これらのフォルダーはコマンド実行前に存在していなければなりません。
オプションの * 引数を渡していない場合、destinationNameで指定した場所にすでにドキュメントが存在するとエラーが生成されます。この引数を渡した場合、既存のファイルは削除され、コピーするドキュメントで置き換えられます。

フォルダーのコピー
フォルダーを指定するためには、sourceName と destinationName に渡す文字列がプラットフォームに対応したフォルダー区切り文字で終わっていなければなりません。例えばWindowsでは "C:\\Element\\"はフォルダーを表し、"C:\\Element"はファイルを表します。
フォルダーをコピーするには、その完全パス名をsourceNameに渡します。このフォルダーは既に存在しなければなりません。フォルダーをsourceName引数に設定した場合、destinationName引数もフォルダーでなければなりません。ディスクにすでに存在する完全フォルダーパス名を渡さなければなりません。
sourceName で指定したフォルダーと同じ名前のフォルダーがdestinationName で指定した場所に既に存在し、そのフォルダーが空でない場合、4Dは項目をコピーする前にフォルダーの内容を確認します。オプションの * 引数を渡していない場合、同じ名前のファイルが既に存在すればエラーが生成されます。この引数を渡した場合、その場所のファイルは削除され、コピーするドキュメントで置き換えられます。