コピー関数
- 更新日2025-07-30
- 5分で読める
ソースパスで指定するファイルまたはディレクトリをターゲットパスで指定する位置にコピーします。ディレクトリをコピーする場合、この関数はすべての内容を再帰的に新規の位置にコピーします。この関数を使用して、ファイルをLLBへコピーしたりLLBからコピーすることはできません。
入力/出力
プロンプト (コピーのためにターゲットパスを選択または入力)
—
プロンプトは、ファイルダイアログボックスのファイルとディレクトリ、または、フォルダリストの下に表示されるメッセージです。 
ソースパス
—
ソースパスは、処理するファイルまたはディレクトリの絶対パスを指定します。空パスまたは相対パスを指定すると、この関数はエラーを返します。
ターゲットパス (ダイアログを使用)
—
ターゲットパスは、処理するファイルまたはディレクトリの新規の絶対パス (新規ファイル名またはフォルダ名を含む) です。 ターゲットパスが空 (デフォルト) の場合、この関数はファイルまたはフォルダを選択するダイアログボックスを表示します。空パスまたは相対パスを指定すると、この関数はエラーを返します。キャンセルされたは、ダイアログボックスをキャンセルするとTRUEになります。 
上書き (F)
—
上書きは、関数によってターゲットパスにある既存のファイルまたはフォルダが上書きされるかどうかを指定します。固有なファイルを含むフォルダを上書きすると、LabVIEWはこれらのファイルを新規フォルダに移動します。(macOSおよびLinux) このパラメータをTRUEに設定してもLabVIEWは読み取り専用ファイルを上書きしません。 
エラー入力
—
エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。 
新規パス
—
新規パスは、ファイルまたはディレクトリの新しい位置を指定します。 この処理が不成功の場合、この関数は新規パスを<無効パス>に設定します。 
キャンセルされた
—
キャンセルされたは、ファイルダイアログボックスをキャンセルするとTRUEになります。 それ以外は、関数がエラーを返した場合でもキャンセルされたがFALSEになります。 
エラー出力
—
エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。 |
この関数は元のファイルまたはディレクトリをコピーして、ターゲットパスの最後の要素に指定する名前でコピーの名前を変更します。ターゲットパスが既存ファイルのパスの場合、この関数は重複パスエラーを返します。ターゲットパスが既存ディレクトリのパスの場合、関数は元のファイルまたはディレクトリ名を使用して、新規ファイルまたはディレクトリを既存ディレクトリ内に配置します。
たとえば、ディレクトリc:\appをd:\app2にコピーした場合、関数はc:\appと同じコンテンツの新規ディレクトリd:\app2を作成します。2回目にディレクトリをコピーする場合、関数は新規サブディレクトリd:\app2\appを作成して、この場所にappのコンテンツを配置します。3回目にディレクトリをコピーすると、関数は重複パスエラーを返します。
また、この関数は、指定された親ディレクトリが有効でない場合など、ターゲットパスが無効パスな場合エラーを返します。
ターゲットパスで指定したファイルまたはディレクトリへの書き込み権限がない場合、この関数はファイルまたはディレクトリをコピーせずに、エラーを返します。「権限を設定」関数を使用して、ファイルまたはディレクトリの権限を設定します。