4. cs:parse-uri
Loads the document at the specified URI and attempts to parse it with the grammar provided. The result will be an XML document that is either the parsed result or a document that specifies that an error occurred.
The grammar provided must be in XML format. This can be obtained with the
cs:grammar
function or, in the case of XML format grammars,
through any convenient means.
$grammar | node | The ixml grammar |
$href | xs:string | The document location |
$grammar | node | The ixml grammar |
$href | xs:string | The document location |
$options | map(xs:string, xs:string) | Parsing options |
The following options are recognized:
cache
If unspecified or specified with the value “
true
” or “yes
”, the grammar will be cached. If any other value is specified, the grammar will not be cached.Caching at this level saves the mapping between the XML representation of the grammar and the underlying Invisible XML parser object.
encoding
Specifies the encoding to use for the input document.
format
Identifies the format of the result:
xml
Returns an XML node.
json
orjson-data
Returns a “data” map. This method will fail if the result contains mixed content.
json-text
orjson-text
Returns a “text” map. This map structure can represent any tree.
It is an error to specify any other value.