fn:filter
Returns those items from the sequence $seq
for which the supplied function
$f
returns true.
filter($seq as item()*, $f as function(item()) as xs:boolean) ➔ item()*
Arguments | |||
| $seq | item()* | The sequence to be filtered |
| $f | function(item()) as xs:boolean | The filtering function (used to test each item in the sequence) |
Result | item()* |
Namespace
http://www.w3.org/2005/xpath-functions
Links to W3C specifications
XPath 3.1 Functions and Operators
Notes on the Saxon implementation
Available in Saxon 9.3 - 9.5 with altered argument order ($f,$seq
), and
provided XPath 3.0 is enabled.
Saxon 10, unlike the W3C XSLT 3.0 specification, makes fn:filter
streamable under appropriate
circumstances. Calls on fn:filter
are streamable provided that the function supplied as the
predicate is either (a) a reference to a user-declared stylesheet function declared with streamability="inspection"
,
or (b) an inline function whose body is grounded and motionless. More specifically, if the predicate function
satisfies these conditions then the posture and sweep of the function call are the same as the posture and sweep of
the first argument.
Available in Saxon-HE from Saxon 10; in Saxon-PE/EE since 9.6.