Counts the number of elements that can be found by the specified Location Rules interpreted against the specified context element.
Parameters:
element
If this parameter is not specified, the generator context element
is used by default,
which is the same as the call: contextElement.findElementsByLRules(...)
See Also: GOMContext.contextElement
locationRules
Each Location Rule is represented by an object created
using LocationRule()
function.
See the description of that function for more detail.
The passed array should be created with a function-call-like construct looking as
LocationRule[] (
...
)
elementTypeSpec
Only those initially found elements will be included in the result enumeration, which comply with at least one of the specified target Element Types.
filterQuery
This should be a boolean subquery created with BooleanQuery()
function.
The subquery will be processed against each initially selected element.
It must return true
if the element is to be counted
and false
otherwise.
The tested element is passed as the generator context element.
Note: The null
value in this parameter
will be treated as no filtering condition.
filterKeyQuery
filterQuery
parameter (above).
When specified, this should be a subquery created
with FlexQuery()
function.
The subquery will be executed for each tested element
(initially passed the filterQuery
condition)
to generate a certain key associated with that element.
The elements whose keys are repeating will be excluded from the counting.
The tested element is passed to the subquery as the generator context element.
The value returned by the subquery should be an object good to be a hash key.
The null
value is also allowed.
Notes:
null
value in this parameter will be treated as no filtering by keys specified.
HashKey()
function.
filterQuery
and filterKeyQuery
are specified,
the filtering by key will be applied after the filtering by condition.
That's important because those operations may be not commutative.
LocationRule(), findElementsByLRules(), checkElementsByLRules(),
countElementsByLPath(), FlexQuery(), BooleanQuery(), HashKey()