fn:unparsed-text

Returns the contents of an external text file, given its URI. The function attempts to infer the encoding. First it looks in the HTTP headers if available. Then it examines the start of the file looking first for a byte-order-mark, and failing that for an XML declaration. If none of this works, it assumes the encoding is UTF-8.

unparsed-text($href as xs:string?) ➔ xs:string?

Arguments

 

$href

xs:string?

The URI of the text file to be read

Result

xs:string?

unparsed-text($href as xs:string?, $encoding as xs:string) ➔ xs:string?

Arguments

 

$href

xs:string?

The URI of the text file to be read

 

$encoding

xs:string

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

Saxon availability

Available in XPath 3.0, XSLT 3.0, XQuery 3.0, and later versions. Available in all Saxon editions.

Notes on the Saxon implementation

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 option STABLE_UNPARSED_TEXT.