Database Module

This module offers utility methods, which can be used for testing and profiling the code. All functions are preceded by the util: prefix.

util:eval

Signatures	`util:eval($expr as xs:string) as item()*`
Summary	Evaluates the argument at runtime.
Rules	This function dynamically evaluates `$expr` as XQuery expression and returns the resulting items.
Examples	The expression `util:eval("1+3")` returns `4`.

Signatures	`util:run($input as xs:string) as item()*`
Summary	Opens the argument as file and evaluates it as at runtime.
Rules	This function opens `$input` as file, evaluates it as XQuery expression, and returns the resulting items.

Signatures	`util:mb($expr as item()) as xs:double`	`util:mb($expr as item(), $cache as xs:boolean) as xs:double`
Summary	Measures the memory consumption for evaluating the argument.
Rules	This function measures the amount of memory that is needed to evaluate `$expr`. If the value of `$cache` is `true()`, the result will be cached. The returned `xs:double` value represents the amount of memory in megabytes.
Examples	The expression `util:mb("1 to 100000")` might return `0`. The expression `util:mb("1 to 100000", true())` might return `26.678`.

Signatures	`util:ms($expr as item()) as xs:double`	`util:ms($expr as item(), $cache as xs:boolean) as xs:double`
Summary	Measures the time needed for evaluating the argument.
Rules	This function measures the time needed to evaluate `$expr`. If the value of `$cache` is `true()`, the result will be cached. The returned `xs:double` value represents the needed time in milliseconds.
Examples	The expression `util:ms("1 to 100000")` might return `25.69`. The expression `util:ms("1 to 100000", true())` might return `208.12`.