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 returnsfalse
.
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()