saxon:compile-query

Compiles an XQuery query.

compile-query($query as xs:string) ➔ jt:net.sf.saxon.query.XQueryExpression

Arguments

 

$query

xs:string

The query to be compiled

Result

jt:net.sf.saxon.query.XQueryExpression

Namespace

http://saxon.sf.net/

Saxon availability

Requires Saxon-PE or Saxon-EE. Available for Java and C/C++ only (not .NET).

Notes on the Saxon implementation

Available since Saxon 9.0. The function is obsolescent, replaced by the newer function saxon:xquery(). The function is implemented in SaxonCS but with the restriction that the type name jt:net.sf.saxon.query.XQueryExpression is not available; the type of the result should be declared as item().

Details

This function takes as input a string containing an XQuery query, and produces as output a compiled query suitable for use with the saxon:query() extension function.

The static context for the query (for example, its namespace bindings and its base URI) must be defined within its own query prolog. It does not inherit any context values from the query or stylesheet in which the saxon:compile-query() function is called. The query cannot access variables or functions defined in the containing query or stylesheet.

There are several ways the string containing the query might be constructed. It can be built directly as a dynamic string in the calling application. In the case of XSLT, it can be read from a file using the unparsed-text() function. It can also be generated by calling saxon:serialize() on an XML representation of the query, using the serialization method saxon:xquery.

The compiled query can be evaluated (repeatedly) using the saxon:query() extension function.

See also:

saxon:query()

saxon:xquery()