vl-file-copy (AutoLISP)

あるファイルの内容を別のファイルにコピーまたは追加します。

サポートされているプラットフォーム: Windows および Mac OS

構文と要素

(vl-file-copy source-file destination-file [append])

source-file

タイプ: 文字列

コピーするファイルの名前。絶対パス名を指定しなかった場合、vl-file-copy 関数は AutoCAD の既定の図面フォルダを検索します。

destination-file

タイプ: 文字列

コピー先のファイルの名前。パス名を指定しなかった場合、vl-file-copy 関数は AutoCAD の既定の図面フォルダに書き出します。

append

タイプ: T または nil

nil 以外の値を指定した場合、source-file が destination-file に追加されます(ファイルの最後に追加されます)。

戻り値

タイプ: 整数または nil

コピーが成功した場合は数値、それ以外の場合は nil。

nil が返される主な原因は、次のとおりです。

• source-file が読み込めない
• source-file がフォルダである
• append 引数が指定されていないか、nil なのに、destination-file が存在する
• destination-file が書き出しモードで開けない(不正なファイル名または読み込み専用ファイル)
• source-file と destination-file が同一の場合

注意

あるファイルの内容を別のファイルにコピーまたは追加します。vl-file-copy 関数は、既存のファイルを上書きしません。追加するのみです。

例

Windows

autoexec.bat を newauto.bat にコピーします。

(vl-file-copy "c:/autoexec.bat" "c:/newauto.bat")
1417

test.bat を newauto.bat にコピーします。

(vl-file-copy "c:/test.bat" "c:/newauto.bat")
nil

newauto.bat が既に存在し、append 引数を指定しなかったので、コピーは失敗します。

今度は append 引数を指定して、上記のコマンドをもう一度繰り返します。

(vl-file-copy "c:/test.bat" "c:/newauto.bat" T)
185

append 引数に T を指定したので、コピーは成功します。

Mac OS

oldstart.sh を newstart.sh にコピーします。

(vl-file-copy "/oldstart.sh" "/newstart.sh")
1417

start.sh を newstart.sh にコピーします。

(vl-file-copy "/start.sh" "/newstart.sh")
nil

newstart.sh が既に存在し、append 引数を指定しなかったので、コピーは失敗します。

今度は append 引数を指定して、上記のコマンドをもう一度繰り返します。

(vl-file-copy "/start.sh" "/newstart.sh" T)
185

append 引数に T を指定したので、コピーは成功します。