load (AutoLISP)

Wertet die AutoLISP-Ausdrücke in einer Datei aus.

Unterstützte Plattformen: Windows und macOS

Signatur

(load filename [onfailure])

Dateiname

Typ: Zeichenfolge

Name der zu ladenden AutoLISP-Datei. Wenn mit dem Argument filename keine Dateierweiterung angegeben wurde, wird mit load eine Erweiterung zum Namen hinzugefügt, wenn nach einer zu ladenden Datei gesucht wird. Bei dieser Funktion werden ggf. mehrere Erweiterungen in der folgenden Reihenfolge ausprobiert:

• .vlx
• .fas
• .lsp

Anmerkung: VLX-Dateien werden nur unter Windows unterstützt.

Sobald von load eine Übereinstimmung gefunden wird, wird die Suche angehalten und die Datei geladen.

filename kann ein Verzeichnispräfix enthalten, wie in C:/function/test1 (Windows) oder /function/test1 (Mac OS). Ein Schrägstrich (/) oder zwei umgekehrte Schrägstriche (\\) sind gültige Verzeichnistrennzeichen. Wenn Sie in der Zeichenfolge filename kein Verzeichnispräfix angeben, wird der AutoCAD-Bibliothekspfad von load nach der angegebenen Datei durchsucht. Wenn die Datei unter diesem Pfad gefunden wird, wird sie von load geladen.

onfailure

Typ: Zeichenfolge

Ein Wert, der zurückgegeben wird, wenn load fehlschlägt.

Wenn das Argument onfailure eine gültige AutoLISP-Funktion ist, wird es ausgewertet. In den meisten Fällen sollte das Argument onfailure eine Zeichenfolge oder ein Atom sein. Dadurch kann eine AutoLISP-Anwendung, die load aufruft, bei einem Fehler alternative Aktionen ausführen.

Anmerkungen

Die Funktion load kann innerhalb einer anderen AutoLISP-Funktion oder sogar rekursiv (in der zu ladenden Datei) verwendet werden.

Wichtig: Beginnend mit AutoCAD 2014-basierten Produkten müssen benutzerdefinierte Anwendungen im abgesicherten Modus arbeiten, wenn für die Systemvariable SECURELOAD der Wert 1 oder 2 festgelegt ist. Wenn Sie im abgesicherten Modus arbeiten, kann das AutoCAD-basierte Produkt nur solche Dateien laden und ausführen, die Code aus vertrauenswürdigen Speicherorten enthalten; die vertrauenswürdigen Speicherorte werden durch die Systemvariable TRUSTEDPATHS festgelegt.

Rückgabewerte

Typ: Zeichenfolge, Subroutine oder Fehler

Nicht angegeben, wenn erfolgreich. Wenn load fehlschlägt, wird der Wert onfailure zurückgegeben; wenn onfailure nicht definiert ist, führt ein Fehler zu einer Fehlermeldung.

Versionsinformationen

Versionen:

• AutoCAD R12 and later on Windows
• AutoCAD 2011 and later on Mac OS

Verlauf

AutoCAD 2021

• Für das Argument filename wurde bisher eine ASCII-Textzeichenfolge akzeptiert, jetzt wird jedoch eine Unicode-Textzeichenfolge akzeptiert.
• Die Systemvariable LISPSYS steuert, welche AutoLISP-Engine verwendet wird und wie sich die Funktion verhält.
  • 0 – ASCII-Zeichenunterstützung (altes Verhalten)
  • 1 oder 2 – Unicode-Zeichenunterstützung
  Anmerkung: Nachdem der Wert der Systemvariablen LISPSYS geändert wurde, muss AutoCAD neu gestartet werden, damit die Änderung wirksam wird.

Beispiele

Bei den folgenden Beispielen wird davon ausgegangen, dass die Datei /fred/test1.lsp die Ausdrücke enthält

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

und dass keine Datei mit der Bezeichnung test2 und der Erweiterung .lsp, .fas oder .vlx vorhanden ist:

(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"