fn:unparsed-text-lines
Equivalent to calling unparsed-text() and splitting the result at newline boundaries.
unparsed-text-lines($source as xs:string?, $options as (xs:string | map(*))?:={}) ➔ xs:string*
Arguments | ||||
| $source | xs:string? | The uri of the text file to be read | |
| $options | (xs:string | map(*))? | := {} | The encoding to be assumed for the text file |
Result | xs:string* | |||
Namespace
http://www.w3.org/2005/xpath-functions
Links to W3C specifications
XPath 3.1 Functions and Operators
XPath 4.0 Functions and Operators
Saxon availability
Available in XPath 3.0, XSLT 3.0, XQuery 3.0, and later versions. Available in all Saxon editions. Available for all platforms.
Notes on the Saxon implementation
Available since Saxon 9.4, provided XPath 3.0 is enabled.
The Saxon implementation is by default not deterministic: if the function is called twice with the same argument, it will read the external file twice, and may return different results if it has changed. If stable results are required, this can be achieved (from 9.8) by setting the configuration property STABLE_UNPARSED_TEXT. This makes the function much less efficient, since the entire file has to be read into memory and retained in memory just in case the same file is read again.