load (AutoLISP)

ファイル内の AutoLISP 式を評価します。

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

構文と要素

(load filename [onfailure])

filename

タイプ: 文字列

ロードする AutoLISP ファイルの名前。filename 引数でファイル拡張子を指定しなかった場合、load 関数は、ロードするファイルを検索するときに、その名前に拡張子を追加します。可能な場合、次の順に複数の拡張子が試されます。

• .vlx
• .fas
• .lsp

注: VLX ファイルは Windows でのみサポートされています。

一致するファイルが見つかると、検索が中止され、そのファイルがロードされます。 

filename 引数には、c:/function/test1 (Windows)や /function/test1 (Mac OS)のように、フォルダの指定を含めることができます。スラッシュ(/)または 2 つの円記号(¥¥)は、有効なフォルダ区切り記号です。filename 引数の文字列でフォルダを指定しなかった場合、load 関数は、指定されたファイルを AutoCAD ライブラリ パスから検索します。このパスのどこかにファイルが見つかると、load 関数はそのファイルをロードします。

onfailure

タイプ: 文字列

load が失敗したときに返される値。

onfailure 引数が AutoLISP の有効な関数である場合に、その関数を評価します。ほとんどの場合、onfailure 引数には文字列かアトムを指定します。これによって、load 関数を呼び出す AutoLISP アプリケーションは、エラーが発生したとき、特別な動作を行うことができます。

注意

load 関数は、他の AutoLISP 関数内から呼び出すことができ、(ロードされたファイルの中から)再帰的に呼び出すこともできます。

重要: AutoCAD 2014 ベースの製品から、システム変数 SECURELOAD を 1 または 2 に設定している場合は、カスタム アプリケーションはセキュア モードでのみ機能することになりました。セキュア モードで動作している場合、プログラムはコードを含むファイルを信頼する場所からロードおよび実行するように制限されます。信頼する場所は、システム変数 TRUSTEDPATHS で指定します。

戻り値

タイプ: 文字列、サブルーチン、エラー

成功した場合は、不定。load 関数が失敗した場合は、onfailure 引数の値。ただし、onfailure 引数を指定しなかった場合は、エラーメッセージが表示されます。

例

たとえば、ファイル /fred/test1.lsp に次のような式が含まれているとします。

(defun MY-FUNC1 (x) 
          ... function body ...
) 
(defun MY-FUNC2 (x) 
          ... function body ...
)

そしてファイル名が test2 で、拡張子が .lsp、.fas、.vlx のファイルが存在しないとします。

(load "/fred/test1")
MY-FUNC2

(load "\\fred\\test1")
MY-FUNC2

(load "/fred/test1" "bad")
MY-FUNC2

(load "test2" "bad")
"bad"

(load "test2")
; error: LOAD failed: "test2"