std-dimstr


Synopsis

(std-dimstr <ele>)

Description

STD-DIMSTR returns the visible textvalue from a DIMENSION entity. With no DIMENSION entity it returns nil.

The textstring is calculated as within AutoCAD.

This maybe used for parametric programs which use dimensions as parameter definition (as Designer of Mechanical Desktop) or just to do special dimension text formatting. But then the associativity will be lost.

It may be used with entity types, entget-lists or entsel picklists.

Note

The implementation calls STD-ENTGET on ename or entsel arguments which uses an entget caching mechanism, because ENTGET is usually slow. But this speed gain may fool return values on deleted entities.

Arguments

ele: A dimension entity of type ENAME, entget-list or entsel picklist.

Return Value

Either a string or nil.

Side Effects

None. It may set an internal *ENTGET-CACHE* symbol, but direct access is forbidden.

Module

(std-require 'STDENT)

#- SMALL

Defined in STDENT