Name
some — Returns true if at least one item of given sequence matches given criterion.
Synopsis
boolean
some
(
|
varname string , |
| test_set sequence , | |
test_expn
boolean
); |
Description
The function creates a temporary local variable, whose name is specified
by varname argument. Then, for every item of
test_set sequence it calculates the
test_expn boolean expression having set the created
variable to that "current" item. If the value of expression is true, the
function immediately returns true without processing the rest of
test_set sequence. If all items of the sequence are
probed without getting true, false is returned. (So if the sequence is
empty, the function returns false).
In any case, temporary variable is destroyed on return.
This function is used in the implementation of "SOME" logical operator in XQUERY, so you will probably use that operator in XQUERY expressions, not the function. This function may be useful in XPATH expressions and in XSLT stylesheets. It is not a part of library of standard XQUERY 1.0 functions.
Parameters
varname
Name of temporary variable
test_set
Sequence of items; these items will be tested by
test_expn
test_expn
Boolean expression which should be calculated for items of
test_set.
Return Types
Boolean
Examples
Example 24.659.
This expression returns true if some reports have zero incomes recorded.
some('income_value', /report/income, $income_value = 0)