Function Entry: SSNAMEX

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

Function Entry: SSNAMEX

Name

ssnamex

Class

Function

Syntax

(ssnamex ss [index])

Arguments and Values

  • ss: a selection set.
  • index (optional): integer or real (zero-based); the element position. With no index, every element is described.

Description

Returns the entity name at index, plus data describing how the entity was selected. Without index, returns the same information for every element in the selection set. Operates only on entities from the current drawing's model and paper spaces; nongraphical objects and entities in block definitions are excluded.

Return Values

A list of descriptors, each of the form (selection-id ename data) where selection-id is one of:

  • 0: nonspecific (Last, All).
  • 1: pick.
  • 2: window or WPolygon.
  • 3: crossing or CPolygon.
  • 4: fence.

Returns nil if index is invalid.

Side Effects

None.

Examples

  • Pick selection: ((1 <Entity name: 1d62da0> 0 (0 (1.0 1.0 0.0)))).
  • Crossing selection: ((3 <Entity name: 1d62d60> 0 -1) (-1 (0 (-1.80879 8.85536 0.0)) …)).
  • Fence selection lists fence-edge intersections.

Availability

  • AutoCAD 2026: documented.
  • BricsCAD V26: presumed compatible.
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Source Notes