load
(load lspfile [ failure-expression
] )
This function loads the specified
lspfile file; all
code outside a (defun) block is evaluated at load-time; nested
loading is supported.
Arguments
|
lspfile (string) Lisp file to be loaded; can optionally
contain a path/folder - without path/folder, all defined support
pathes are searched
failure-expression (optional) if specified
|
Return
|
value of last evaluated
expression;
in case of an error, and if
failure-expression is specified, then failure-expression is
returned
|
Example
|
(load "MyTest.lsp"
"oops")
- returns last-evaluated expression, if no
error happens
- returns the string "oops" if an error
happened
(load "MyTest.lsp")
- returns last-evaluated expression, if no
error happens
- if an error happens, Lisp loading stops and
error message is shown in command line
|
Remarks
|
if no file extension is
specified, BricsCAD Lisp searches in this sequence :
1. name.des
2. name.lsp
if failure-expression is not
specified, and any Lisp error happens during load-time, the Lisp
processing is stopped, and an error message is
displayed;
if failure-expression is
specified, and any Lisp error happens during load-time, Lisp
processing is continued, no error message is shown
|
Remarks 2
|
since BricsCAD
V20, the (load) functions also supports
Lisp files which are stored as "Unicode" files :
- using UTF-8 format in "Little-Endian" byte
order (Intel/AMD processors)
- using UTF-16 format in "Little-Endian" byte
order (Intel/AMD processors)
!!! for both UTF-8/16 format, the
Byte-Order-Mark (BOM) is absolutely required; UTF-8 without BOM
might fail !!!
|