Function Entry: CLAL-COMMAND-LOG

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

Function Entry: CLAL-COMMAND-LOG

Name

clal-command-log

Class

clautolisp Extension Function

Syntax

(clal-command-log)

Arguments and Values

No arguments.

Description

Return the token sequences that command / command-s / vl-cmdf calls have routed through the active host's command channel in this session, oldest first. Each element is a list of strings — the normalized command-line tokens exactly as sent: "" is the RETURN token, the one-backslash string "\\" the PAUSE token, points are "X,Y[,Z]" coordinate spellings.

Under MockHost (the default backend, which has no command engine) this log is the whole observable effect of a command call; it is the deterministic assertion surface for headless test rigs.

Return Values

A proper list of lists of AutoLISP strings; nil when no command has been issued.

Side Effects

None.

Affected By

  • The selected host backend (NullHost / MockHost / LiveHost).
  • Prior command / command-s / vl-cmdf calls in the session.

Exceptional Situations

Raises :host-not-supported when the active backend keeps no command log (e.g. the bare NullHost).

Examples

(command "._LINE" (list 0.0 0.0 0.0) (list 10.0 10.0 0.0) "")
=> nil
(clal-command-log)
=> (("._LINE" "0.0,0.0,0.0" "10.0,10.0,0.0" ""))

Availability

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

Source Notes

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