Function Entry: CLAL-SUPPRESS-ENC-DIAGNOSTIC

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

Function Entry: CLAL-SUPPRESS-ENC-DIAGNOSTIC

Name

clal-suppress-enc-diagnostic

Class

clautolisp Extension Function

Syntax

(clal-suppress-enc-diagnostic [code …])

Arguments and Values

  • code — zero or more string designators (strings or symbols); each is canonicalised to a :enc-NAME code.

Description

Add each code to the active per-code encoding-diagnostic suppression list. Subsequent diagnostic signals with a matching code emit nothing. The suppression is dynamically scoped to the running AutoLISP session and persists across load / open until re-enabled with clal-enable-enc-diagnostic. Typically used as a pragma at the top of a source file.

Return Values

The (possibly extended) list of currently-suppressed codes, as a list of AutoLISP strings (downcased code names).

Side Effects

Mutates the session's encoding-diagnostic suppression list.

Affected By

  • The current suppression list (codes are unioned in).

Exceptional Situations

Argument-type errors propagate when a code is not a valid string designator.

Examples

(clal-suppress-enc-diagnostic 'enc-extension-used 'enc-foreign-dialect)
=> ("enc-foreign-dialect" "enc-extension-used")

Availability

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

Source Notes

  • clautolisp-only extension; part of the encoding-diagnostics family. See this chapter's Overview.