Returns all elements that are associated with the given key 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 shows the error message.

key
The hash key
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 elements follow in the enumeration in the same order as they have been put initially in the element map by the given key.

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

See Also:

prepareElementMap(), countElementsByKey(), BooleanQuery()