Parameter Type Description

inObject Longint A handle to an object inTag String ^→ Tag of the item to set inVarPointer Variable pointer ^→ Pointer to variable which contains → value to store

Discussion

OT PutVariable puts the contents of the variable pointed to by inVarPointer into inObject. Every 4D variable type but 2D arrays can be stored with this command, including Boolean variables and arrays. Once stored, the data can either be retrieved with OT GetVariable or with the OT Get command appropriate to the variable’s type.

If inObject is not a valid object handle, an error is generated and OK is set to zero.

If no item in the object has the given tag, a new item is created.

If an item with the given tag exists and has the type Type(variablePointer->), its value is replaced.

If an item with the given tag exists and has any other type, an error is generated and OK is set to zero if the OT VariantItems option is not set, otherwise the existing item is deleted and a new item is created.

Note Boolean items stored in objects with OT PutVariable can only be retrieved with OT GetVariable.

See Also

OT GetVariable