Funkce prostoru jmen VLX

(vl-arx-import ['function | "application"])
 
Argumenty:
 
function
 - jméno importované funkce
 
application
 - řetězec - jméno aplikace, které funkce má být importována
 
Poznámka:
  - nejsou-li uvedeny některé argumenty nebo jsou nil - vl-arx-importuje všechny funkce z aktuálního prostoru jmen dokumentu
 
Popis:
  - importuje ObjectARX / ADSRX funkce do odděleného prostoru jmen VLX
 
Návratové hodnoty:
  - nespecifikovány

(vl-doc-export 'function)
 
Argumenty:
 
'function
- jméno exportované funkce
 
Popis:
  - udělá funkci přístupnou z aktuálního dokumentu
  - nesmí být použita v rámci defun příkazu
 
Návratové hodnoty:
  - nespecifikovány
 
Příklady:
  Soubor kertrats.lsp je kompilován do prostoru jmen VLX. VLX soubor má jméno kertrats.vlx. Příkaz vl-doc-export udělá funkci kertrats viditelnou ve všech dokumentech, které nahrají kertrats.vlx:
  (vl-doc-export 'kertrats)
  (defun kertrats ()
  (princ "This function goes nowhere")
  )

(vl-doc-import application ['function...])
 
Argumenty:
 
application
 - jméno VLX aplikace, jejíž funkce mají být importovány, nesmí se uvést koncovka .vlx
 
'function...
 - jedno nebo více jmen funkcí k importování. Není-li uvedeno jméno žádné funkce, jsou importovány všechny funkce exportované v argumentu application
 
Popis:
  - importuje předem exportovanou funkci do VLX prostoru jmen
 
Návratové hodnoty:
  - nespecifikovány
 
Příklady:
  Import funkce ldataget z ldatatest aplikace:
  (vl-doc-import "ldatatest" 'ldataget)
    vrací nil

(vl-doc-ref 'symbol)
 
Argumenty:
 
'symbol
 - jméno proměnné
 
Popis:
  - získání hodnoty proměnné z aktuálního prostoru jmen dokumentu
  - může být použito v odděleném prostoru jmen VLX aplikace
 
Návratové hodnoty:
  - hodnota proměnné identifikované argumentem symbol
 
Příklady:
  (vl-doc-set 'foobar "Rinky dinky stinky")
  (vl-doc-ref 'foobar)
    vrací "Rinky dinky stinky"

(vl-doc-set 'symbol value)
 
Argumenty:
 
'symbol
 - jméno proměné
 
value
 - libovolná hodnota
 
Popis:
  - nastavení hodnoty proměnné z aktuálního prostoru jmen dokumentu
  - může být použita k nastavení hodnoty proměnné umístěné v odděleném prostoru jmen VLX aplikace
 
Návratové hodnoty:
  - nastavená hodnota
 
Příklady:
  (vl-doc-set 'foobar "Rinky dinky stinky")
    vrací "Rinky dinky stinky"

Podívej se na funkci vl-doc-ref.

(vl-exit-with-error msg)
 
Argumenty:
 
msg
 - řetězec
 
Popis:
  - předá kontrolu z VLX správce chyb na *error* funkci volaného prostoru jmen
  - funkce se používá ve VLX aplikaci, která běží ve svém vlastním prostoru jmen. Když je funkce zavolána, předá se řízení *error* funkci, stack je nenatažený a řízení je předáno příkazovému řádku
 
Návratové hodnoty:
  - žádná
 
Příklady:
  Předání *error* funkce volaného prostoru jmen:
  (defun *error* (msg)
  ... ; processing in VLX namespace/execution context
  (vl-exit-with-error (strcat "My application bombed! " msg)))

Podívej se na funkci vl-exit-with-value.

(vl-exit-with-value value)
 
Argumenty:
 
value
 - libovolná hodnota
 
Popis:
  - vrátí hodnotu funkce, která vyvolala VLX z jiného prostoru jmen
  - VLX *error* může použít vl-exit-with-value funkci k vrácení hodnoty programu, který vyvolal VLX
 
Návratové hodnoty:
  - hodnota proměnné value
 
Příklady:
  Použití funkce vl-exit-with-value k vrácení hodnoty 3 funkci, která vyvolala VLX:
    (defun *error* (msg)
    ... ; processing in VLX-T namespace/execution context
    (vl-exit-with-value 3))

Podívej se na funkci vl-exit-with-error.

(vl-list-exported-functions [appname])
 
Argumenty:
 
appname
 - jméno nahrávané VLX aplikace, bez koncovky .vlx
 
Popis:
  - funkce pro export seznamu
 
Návratové hodnoty:
  - seznam jmen exportovaných funkcí
  - nil - v případě, že neexistují funkce na export
 
Příklady:
  _$ (vl-list-exported-functions "whichexpns")
    vrací ("WHICHNAMESPACE")

Podívej se na funkci vl-list-loaded-vlx.

(vl-list-loaded-vlx)
 
Popis:
  - získání seznamu všech souboů VLX oddělených prostorů jmen přiřazených aktuálnímu dokumentu.
 
Návratové hodnoty:
  - seznam jmen identifikující aplikace VLX běžící v oddělených prostorech jmen přidělených aktuálnímu dokumentu AutoCADu
  - nil - v případě, že nejsou přiděleny žádné VLX aplikace
 
Příklady:
  Test zda jsou přiřazeny nějaké aplikace VLX k aktuálnímu dokumentu AutoCADu:
  _$ (vl-list-loaded-vlx)
    vrátí-li funkce nil = žádné aplikace dokument neobsahuje
 
  Nahrání dvou VLX aplikací, které byly kompilovány pro běh ve svých vlastních prostorech jmen:
  _$ (load "c:/my documents/visual lisp/examples/foo1.vlx")
    vrácí nil
  _$ (load "c:/my documents/visual lisp/examples/foo2.vlx")
    vrácí nil
 
  Test zda jsou nahrány nějaké aplikace VLX v aktuálním dokumentu AutoCADu:
  _$ (vl-list-loaded-vlx)
    vrácí (FOO1 FOO2)
  _$ (load "c:/my documents/visual lisp/examples/foo2.vlx")
    vrácí nil
 
  Nahrání VLX aplikace, která byla kompilována k běhu v prostoru jmen dokumentu:
  _$ (load "c:/my documents/visual lisp/examples/foolocal.vlx")
    vrácí nil
 
  Test zda jsou nahrány nějaké aplikace VLX:
  _$ (vl-list-loaded-vlx)
    vrácí (FOO1 FOO2)
  Naposled nahraná funkce není vrácena, protože byla nahrána do prostoru jmen dokumentu; VLX nevlastní její vlastní prostor jmen!

(vl-unload-vlx appname)
 
Argumenty:
 
appname
 - jméno VLX aplikace nahrané do vlastního prostoru jmen, bez koncovky .vlx
 
Poznámka:
  - funkce vl-unload-vlx nedokáže odstranit VLX aplikaci nahranou do prostoru jmen aktuálního dokumentu
 
Popis:
  - odstraní VLX aplikaci nahranou do vlastního prostoru jmen
 
Návratové hodnoty:
  - T - je-li vše v pořádku
  - error - v případě výskytu chyby
 
Příklady:
  Předpokládejme, že vlxjm je jméno aplikace nahrané do jejího vlastního prostoru jmen. Následující příkaz odstraní aplikaci vlxjm:
  (vl-unload-vlx "vlxjm")
    vrací T
  Pokusíme-li se odstranit aplikaci znovu:
  (vl-unload-vlx "vlxjm")
    vrací ; *** ERROR: LISP Application is not found VLXNS

Podívej se na funkce load a vl-vlx-loaded-p.

(vl-vlx-loaded-p appname)
 
Argumenty:
 
appname
 - jméno VLX aplikace
 
Popis:
  - funkce stanoví zda je oddělený prostor jmen VLX právě nahrán
 
Návratové hodnoty:
  - T - je-li aplikace nahraná
  - nil - není-li nahrána žádná aplikace
 
Příklady:
  Zkontrolování zda aplikace vlxjm je nahrána do vlastního prostoru jmen:
  (vl-vlx-loaded-p "vlxns")
    vrací nil - aplikace není nahraná
 
  Nahrajeme VLX aplikaci:
  (load "vlxns.vlx")
    vrací nil - aplikace je nahraná
 
  Zkontrolování zda aplikace vlxjm je nahrána do vlastního prostoru jmen:
  (vl-vlx-loaded-p "vlxns")
    vrací T - aplikace vlxns je nahraná

Podívej se na funkce load a vl-unload-vlx.