std-puttextval | ![]() |
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.
ele: Either an entity type, entget-list or entsel picklist.
str: A string
1 on success, 0 on no change or wrong entity type.
Changes the entity. Mostly used only because of the side-effect, the returned number is only sometimes used for the sum of changed entities.
(std-require 'STDENT)
Defined in STDENT