Associates a number of different elements with the same specified key in the element map with the specified identifier.
Parameters:
elementMapId
The element map identifierNote: When the element map with such an identifier does not exist, the generator shows the error message.
key
The hash key with which the elements are to be associated.Note:
null
value for the hash key is not allowed. In that case the function simply does nothing and returns0
.
elements
The enumeration of elements to be associated with the specified key.
Returns:
The number of new key/element associations added to the element map.
See Also:
createElementMap(), putElementByKey(),
putElementByKeys(), putElementsByKeys()