create_dict — Create a new empty dictionary.
create_dict( : : : DictHandle)
create_dict creates a new empty dictionary and returns
The dictionary serves as an associative array-like container allowing to
store an arbitrary number of values associated with unique keys (integers
Each key can refer either to a tuple or to an iconic object.
These are stored in the dictionary using
respectively, from where they can be retrieved again using
The data stored in the dictionary is always a copy of the original
data, being it control parameters or objects.
The original data
can thus be reused immediately after the
The following particularities apply:
Handles: Storing any handle in the dictionary will copy the handle value, but not the resource behind the handle.
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
Handle of the newly created dictionary.
Number of elements: DictHandle == 1
Dicts :=  for idx := 0 to 4 by 1 create_dict (DictHandle) Dicts[idx] := DictHandle endfor * ...
Returns 2 (H_MSG_TRUE) unless a resource allocation error occurs.