Using Item Tags - Using Item Tags The key storing values retrieving values from objects know how use item references tags Tags names give object items when store put retrieve get values from object example put Real value object tag ldquomy realrdquo would use OT PutReal Assuming object had just been created would create new item object referenced handle object retrieve value stored tag would use realOT GetReal realquot To replace existing value quotmy realquot would simply call OT PutReal again like so OT PutReal Tag Characteristics Tags characters long consist characters except period used indicate embedded objects Capitalization diacritical marks normally not thus quotMy Realquot quotmy quotmy realquot considered same tag ObjectTools

Using Item Tags

The key to storing values into and retrieving values from objects is to know how to use item references, or tags. Tags are the names you give to object items when you store (put) and retrieve (get) values from an object. For example, to put the Real value 27.13 into an object with the tag “my real”, you would use:

OT PutReal ($object;"my real";27.13)

Assuming the object had just been created, this would create a new item in the object referenced by the handle $object. To retrieve the value stored with that tag, you would use:

$real:=OT GetReal ($object;"my real")

To replace the existing value of "my real", you would simply call OT PutReal again, like so:

OT PutReal ($object;"my real";827.1931)

Tag Characteristics

Tags can be up to 255 characters long, and may consist of any characters except period (.), as that is used to indicate embedded objects. Capitalization and diacritical marks are normally not signiﬁcant; thus "My Real", "my réal" and "my real" are considered the same tag by ObjectTools.

If necessary, you can set an option to have both case and diacritical marks be signiﬁcant when matching tag names.

← →

Published date: Fri, 14 Jul 2006 17:45:28 GMT → View XML Version

Edit this page now