Function Entry: CLAL-NAV-FILE

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

Function Entry: CLAL-NAV-FILE

Name

clal-nav-file

Class

clautolisp Extension Function

Syntax

(clal-nav-file path [line])

Arguments and Values

  • path — a string (or symbol) naming a file.
  • line — optional integer; the form on or containing this line is the starting point. Omitted starts at the first form.

Description

Enter the aldo debugger navigating the top-level forms of file path, starting at the form on or containing line when given (pre-debug navigation). A no-op unless a debug session is active (it funcalls the runtime's debug-nav hook with (:file path line)).

Return Values

Always nil.

Side Effects

When a debug session is active, navigates the debugger to the file's forms; otherwise none.

Affected By

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

Exceptional Situations

Signals :bad-argument when path is neither a symbol nor a string, or when line is supplied and is not an integer.

Examples

(clal-nav-file "/home/me/lib/util.lsp")
(clal-nav-file "/home/me/lib/util.lsp" 42)
=> 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.