Function Entry: DICTRENAME

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

Function Entry: DICTRENAME

Name

dictrename

Class

Host Function

Syntax

(dictrename ename old-name new-name)

Arguments and Values

  • ename: dictionary entity name
  • old-name: old entry name
  • new-name: new entry name

Autodesk documents old-name and new-name as strings.

Description

Renames an entry in a dictionary.

Return Values

String or nil.

If successful, returns new-name.

Side Effects

Modifies dictionary naming state.

Compatibility

Part of the dictionary mutation API.

Availability

  • AutoCAD 2026: documented (per Autodesk reference page).
  • BricsCAD V26: presumed compatible (no contradicting page found).
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Notes

  • Autodesk documents that nil is returned if the old name is not present, if the dictionary is invalid, if the new name is invalid, or if the new name already exists.