Function Entry: ENTMAKEX

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

Function Entry: ENTMAKEX

Name

entmakex

Class

Function

Syntax

(entmakex [elist])

Arguments and Values

  • elist (optional): an entity-definition list in the format returned by entget. Required group codes must be present; optional codes default if omitted.

Description

Creates a new entity, gives it a handle and entity name, and returns the entity name. Unlike entmake, the new entity has no owner; it must be assigned ownership before being saved (e.g. by adding it to a dictionary via dictadd). Supports both graphical and nongraphical entities.

Return Values

The new entity name on success; nil if the entity cannot be created.

Side Effects

Allocates a new entity in the current drawing.

Examples

  • (entmakex '((0 . "CIRCLE") (62 . 1) (10 4.0 3.0 0.0) (40 . 1.0))) returns <Entity name: 1d45558>.

clautolisp

entmakex returns the new entity's ENAME (never the definition list — see entmake), feedable straight into entget~/~entmod~/~entdel. It shares entmake's validation, family registry, layer/subclass defaulting and subentity-ownership behaviour, and likewise returns nil

  • ERRNO 36 (no raised condition) when the data does not describe a

creatable entity. (Historically clautolisp collapsed entmakex into entmake and wrongly returned the list; fixed in clautolisp 1.6.5.)

It also shares entmake's R13+ subclass-marker contract (see the ENTMAKE *** clautolisp note), which the autolisp-spec resolves in AutoCAD's favour: entmakex of an R13+ entity (ELLIPSE, LWPOLYLINE, RAY, XLINE, MTEXT, SPLINE) whose data omits the (100 . "AcDb...") subclass markers returns nil under --dialect autocad-2026, clautolisp and strict (the normative dialects); --dialect bricscad-v26 and --lax reproduce BricsCAD's leniency and accept it. strict and --dialect bricscad-v26 emit the [entmake-subclass-marker] warning.

Availability

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

Source Notes