/// <summary>
/// Get a list of external variables used by the expression. This will include both variables that were explicitly
/// declared to the <c>XPathCompiler</c>, and (if the <c>AllowUndeclaredVariables</c> option was set) variables that
/// are referenced within the expression but not explicitly declared.
/// </summary>
/// <returns>
/// An IEnumerator over the names of the external variables, as instances of <c>QName</c>.</returns>
public IEnumerator EnumerateExternalVariables()
{
ArrayList list = new ArrayList();
JIterator iter = env.iterateExternalVariables();
while (iter.hasNext())
{
JXPathVariable var = (JXPathVariable)iter.next();
JStructuredQName q = var.getVariableQName();
list.Add(new QName(q.getPrefix(), q.getURI(), q.getLocalPart()));
}
return(list.GetEnumerator());
}
/// <summary>
/// Compile an expression supplied as a String.
/// </summary>
/// <example>
/// <code>
/// XPathExecutable q = compiler.Compile("distinct-values(//*/node-name()");
/// </code>
/// </example>
/// <param name="source">A string containing the source text of the XPath expression</param>
/// <returns>An <c>XPathExecutable</c> which represents the compiled xpath expression object.
/// The XPathExecutable may be run as many times as required, in the same or a different
/// thread. The <c>XPathExecutable</c> is not affected by any changes made to the <c>XPathCompiler</c>
/// once it has been compiled.</returns>
/// <exception cref="StaticError">
/// Throws a <c>Saxon.Api.StaticError</c> if there is any static error in the XPath expression.
/// This includes both syntax errors, semantic errors such as references to undeclared functions or
/// variables, and statically-detected type errors.
/// </exception>
public XPathExecutable Compile(String source)
{
if (cache != null)
{
XPathExecutable exec = (XPathExecutable)cache[source];
if (exec != null)
{
return(exec);
}
}
try
{
JIndependentContext ic = env;
if (ic.isAllowUndeclaredVariables())
{
// self-declaring variables modify the static context. The XPathCompiler must not change state
// as the result of compiling an expression, so we need to copy the static context.
ic = new JIndependentContext(env);
for (JIterator iter = env.iterateExternalVariables(); iter.hasNext();)
{
JXPathVariable var = (JXPathVariable)iter.next();
JXPathVariable var2 = ic.declareVariable(var.getVariableQName());
}
}
JXPathEvaluator eval = new JXPathEvaluator(config);
eval.setStaticContext(ic);
JXPathExpression cexp = eval.createExpression(source);
XPathExecutable exec = new XPathExecutable(cexp, config, ic);
if (cache != null)
{
cache[source] = exec;
}
return(exec);
}
catch (net.sf.saxon.trans.XPathException err)
{
throw new StaticError(err);
}
}
/// <summary>
/// Compile an expression supplied as a String.
/// </summary>
/// <example>
/// <code>
/// XPathExecutable q = compiler.Compile("distinct-values(//*/node-name()");
/// </code>
/// </example>
/// <param name="source">A string containing the source text of the XPath expression</param>
/// <returns>An <c>XPathExecutable</c> which represents the compiled xpath expression object.
/// The XPathExecutable may be run as many times as required, in the same or a different
/// thread. The <c>XPathExecutable</c> is not affected by any changes made to the <c>XPathCompiler</c>
/// once it has been compiled.</returns>
public XPathExecutable Compile(String source)
{
JIndependentContext ic = env;
if (ic.isAllowUndeclaredVariables())
{
// self-declaring variables modify the static context. The XPathCompiler must not change state
// as the result of compiling an expression, so we need to copy the static context.
ic = env.copy();
for (JIterator iter = env.iterateExternalVariables(); iter.hasNext();)
{
JXPathVariable var = (JXPathVariable)iter.next();
JXPathVariable var2 = ic.declareVariable(var.getVariableQName());
}
}
JXPathEvaluator eval = new JXPathEvaluator(config);
eval.setStaticContext(ic);
JXPathExpression cexp = eval.createExpression(source);
return(new XPathExecutable(cexp, config, ic));
}
