Converts the specified enumeration of source elements (i.e. GOMElement objects) into another enumeration of elements, in which some of the source elements may be passed unchanged or replaced with new elements produced from the corresponding source ones.

The ordering of elements in the result enumeration will correspond to the original one.

Parameters:

sourceElements

The enumeration of source elements.
elementsQuery
Specify the subquery that returns one or multiple elements to be added to the result enumeration.

The subquery should be prepared using FlexQuery() function. It will be executed against each source element, which is passed to the subquery as the generator context element (see GOMContext.contextElement).

The subquery should return either a single element (i.e. GOMElement object) or an enumeration of elements, all of which will be added to the result enumeration. Any other value returned by the subquery will be ignored.

Returns:
The result enumeration of elements.

When either sourceElements or elementsQuery parameter is null, an empty enumeration is returned.