std-gettextval


Synopsis

(std-gettextval <ele>)

Description

STD-GETTEXTVAL returns the visible textvalue from any text-like entity. From a DIMENSION the internal calculated visible value, from a MTEXT all textlines concatenated together.

It also handles ATTDEF, ATTRIB and TEXT entities.

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: Either an entity type, 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)

Defined in STDENT