Associates a number of different elements with the same 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 elements are to be associated.

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

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