Associates the specified element with the specified key in the element map with the specified identifier.

Parameters:

elementMapId

The element map identifier.

Note: When the element map with such an identifier does not exist, the generator raises an error.

key
The hash key with which the specified element is to be associated.

Note: null value for the hash key is not allowed. In that case the function simply does nothing and returns false.

element
The element to be associated with the specified key.

Returns:

true, if a new key/element association has been created;
false, if such an association already existed in that element map.

See Also:

findElementByKey(), checkElementByKey(), removeElementByKey()