4D v14.3

COPY DOCUMENT

ホーム

 
4D v14.3
COPY DOCUMENT

COPY DOCUMENT 


 

COPY DOCUMENT ( sourceName ; destinationName {; newName} {; *} )  
引数   説明
sourceName  文字 in コピーするファイルやフォルダーのパス名
destinationName  文字 in ファイルやフォルダーコピーの配置先名またはパス名
newName  文字 in コピーされたファイルまたはフォルダの新しい名前
演算子 in 存在する場合、既存のドキュメントを上書きする

説明   

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

  • ファイルのコピー
    この場合sourceName引数には以下のどちらかを渡す事ができます。
    • ボリュームのルートから始まる完全なファイルパス名
    • データベースフォルダーから相対的なパス名
    destinationName引数には複数のタイプで場所を指定できます:
    • ボリュームのルートから始まる完全なファイルパス名。ファイルはこの場所にコピーされます。
    • ファイル名または相対的なファイルパス名。ファイルはデータベースフォルダー内にコピーされます。サブフォルダーはコマンド実行前に存在していなければなりません。
    • データベースフォルダーから相対的な完全フォルダーパス名またはパス名(destinationNameはプラットフォームに応じたフォルダー区切り文字で終わっていなければなりません)。ファイルは指定したフォルダーにコピーされます。これらのフォルダーはコマンド実行前に存在していなければなりません(自動的に作成されることはありません)。
    オプションの * 引数を渡していない場合、destinationNameで指定した場所にすでにドキュメントが存在するとエラーが生成されます。この引数を渡した場合、既存のファイルは削除され、コピーするドキュメントで置き換えられます。
  • フォルダーのコピー
    フォルダーを指定するためには、sourceNamedestinationName に渡す文字列がプラットフォームに対応したフォルダー区切り文字で終わっていなければなりません。例えばWindows環境下では "C:\\Element\\"はフォルダーを表し、"C:\\Element"はファイルを表します。
    フォルダーをコピーするには、その完全パス名をsourceNameに渡します。このフォルダーは既に存在しなければなりません。フォルダーをsourceName引数に設定した場合、destinationName引数もフォルダーでなければなりません。このとき、ディスクにすでに存在する完全フォルダーパス名を渡さなければなりません。
    sourceName で指定したフォルダーと同じ名前のフォルダーがdestinationName で指定した場所に既に存在し、そのフォルダーが空でない場合、4Dは項目をコピーする前にフォルダーの内容を確認します。オプションの * 引数を渡していない場合、同じ名前のファイルが既に存在すればエラーが生成されます。この引数を渡した場合、その場所のファイルは削除され、コピーするドキュメントで置き換えられます。

ファイルをフォルダーにコピーするために、sourceName にファイルを、destinationName にフォルダーを渡すことは可能です。

任意の newName 引数を渡した場合、コピーした場所のドキュメント(ファイルまたはフォルダー)を改名します。ファイルのコピーの際に渡した場合は、この引数は destinationName 引数に渡された名前を置き換えます。

次の例を使用して、そのドキュメントがあるフォルダ内でドキュメントを複製します。

 COPY DOCUMENT("C:\\FOLDER\\DocName";"C:\\FOLDER\\DocName2")

次の例を使用して、ドキュメントをデータベースフォルダにコピーします(表示されているC:\\FOLDERは、データベースフォルダではありません) 。

 COPY DOCUMENT("C:\\FOLDER\\DocName";"DocName")

次の例を使用して、ドキュメントを一つのボリュームから他のボリュームへコピーします。

 COPY DOCUMENT("C:\\FOLDER\\DocName";"F:\\Archives\\DocName.OLD")

次の例を使用して、そのドキュメントがあるフォルダ内で既存のコピーを上書きして、ドキュメントを複製します。

 COPY DOCUMENT("C:\\FOLDER\\DocName";"C:\\FOLDER\\DocName2";*)

指定したフォルダーに同じ名前でファイルをコピー:

 COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\")

指定したフォルダーに同じ名前でファイルをコピー。既存のファイルは上書きする:

 COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\"; *)

フォルダーを他のフォルダーにコピー (両フォルダーは既に存在しなければなりません):

 COPY DOCUMENT("C:\\Projects\\";"C\\Archives\\2011\\")

以下の例はデータベースフォルダー内に異なるファイルやフォルダーを作成します(ただしこれはWindows用の例題です)。どの場合においても、"folder2"というフォルダーが先に存在していなければなりません。

 COPY DOCUMENT("folder1\\name1";"folder2\\")
  //"folder2/name1" という名前のファイルを作成します。
 
 COPY DOCUMENT("folder1\\name1";"folder2\\" ; "new")
  //"folder2/new" という名前のファイルを作成します。
 
 COPY DOCUMENT("folder1\\name1";"folder2\\name2")
  //"folder2/name2" という名前のファイルを作成します。
 
 COPY DOCUMENT("folder1\\name1";"folder2\\name2";"new")
  //"folder2/new" という名前のファイルを作成します(name2は無視されます)。
 
 COPY DOCUMENT("folder1\\" ; "folder2\\")
  //"folder2/folder1/" という名前のフォルダを作成します。
 
 COPY DOCUMENT("folder1\\" ; "folder2\\" ; "new")
  //"folder2/new/" という名前のファイルを作成します。

 
プロパティ 

プロダクト: 4D
テーマ: システムドキュメント
番号: 541

このコマンドはOKシステム変数を更新しますErrorシステム変数が更新されることがあります。

 
履歴 

New
初出: 4D v6
変更: 4D v13
変更: 4D v14

 
参照 

MOVE DOCUMENT
システムドキュメント

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)

Inherited from : COPY DOCUMENT ( 4D v13.5)