std-puttextval


Synopsis

(std-puttextval <ele> <str>)

Description

STD-PUTTEXTVAL is the modifying counterpart of STD-GETTEXTVAL. It changes the visible textvalue for any text-like entity. If used with a DIMENSION the associativity will be lost.

It sets the group 1 in the entity types TEXT, MTEXT, ATTRIB and the main DIMENSION entity and the group 2 in an ATTDEF.

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.

str: A string

Return Value

1 on success, 0 on no change or wrong entity type.

Side Effects

Changes the entity. Mostly used only because of the side-effect, the returned number is only sometimes used for the sum of changed entities.

Module

(std-require 'STDENT)

Defined in STDENT