Returns all elements that are associated with at least one of the given keys in the element map with the specified identifier and satisfy the filter condition (if specified).

Parameters:

elementMapId

The element map identifier.

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

keys
The array containing the hash keys
filterQuery
This parameter allows you to specify an additional condition on the elements included in the result enumeration.

When specified, this should be a boolean subquery created with BooleanQuery() function. The subquery will be processed against each initially selected element and should return true if the element must be included in the result enumeration and false otherwise. The tested element is passed as the generator context element.

Returns:

The enumeration of the result elements.

The order in which the elements appear in the enumeration is this:

  1. The first follow the elements associated with the keys[0]. These elements will be ordered the same as they have been put intitally in the map by that key.
  2. Then follow the elements associated with the keys[1], also ordered the same as they have been put in the map.
  3. This is repeated for all other keys successively.

If an element is associated with more than one keys, it will appear only once for the first of those keys.

Note that two different GOMElement instances represent the same DSM elements when their GOMElement.id identifiers are equal.

If there are no elements associated with the keys, the returned enumeration is empty.

See Also:

prepareElementMap(), countElementsByKeys(), BooleanQuery()