Function Entry: CLAL-NAV-DIRECTORY

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: CLAL-NAV-DIRECTORY

Name

clal-nav-directory

Class

clautolisp Extension Function

Syntax

(clal-nav-directory [path])

Arguments and Values

  • path — optional string (or symbol) naming a directory; the current directory when omitted.

Description

Enter the aldo debugger browsing the directory path so you can walk the file system and enter files (pre-debug navigation). A no-op unless a debug session is active (it funcalls the runtime's debug-nav hook with (:directory path), path being nil when omitted).

Return Values

Always nil.

Side Effects

When a debug session is active, opens the debugger's directory browser; otherwise none.

Affected By

  • Whether a debug session (aldo) is currently active.

Exceptional Situations

Signals :bad-argument when path is supplied and is neither a symbol nor a string.

Examples

(clal-nav-directory)
(clal-nav-directory "/home/me/lib/")
=> nil

Availability

  • clautolisp: documented (this entry); implemented since clautolisp 1.4.x.
  • AutoCAD: NOT present.
  • BricsCAD: NOT present.

Source Notes

  • clautolisp-only extension; see this chapter's Overview for the rationale and probing convention.