Function Entry: CLAL-SELECT-FILE

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

Function Entry: CLAL-SELECT-FILE

Name

clal-select-file

Class

clautolisp Extension Function

Syntax

(clal-select-file path line)

Arguments and Values

  • path — a string (or symbol) naming a file.
  • line — an integer line number.

Description

Select path:line as the source the debugger's ls command shows (pre-debug navigation). A no-op unless the debugger's select-file hook is installed (it funcalls that runtime hook with path and line).

Return Values

Always nil.

Side Effects

When the debugger is active, changes which source location its ls command displays; 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 not an integer.

Examples

(clal-select-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.