net.sf.saxon.functions

Class KeyFn

java.lang.Object

net.sf.saxon.om.AbstractItem

net.sf.saxon.functions.AbstractFunction

net.sf.saxon.functions.SystemFunction

net.sf.saxon.functions.KeyFn

All Implemented Interfaces:

PullEvent, Callable, Function, GroundedValue, Item, Sequence

public class KeyFn
extends SystemFunction

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	KeyFn.SubtreeFilter Mapping class to filter nodes that have the origin node as an ancestor-or-self

Constructor Summary

Constructors

Constructor and Description
KeyFn()

Method Summary

Methods

Modifier and Type	Method and Description
Sequence	call(XPathContext context, Sequence[] arguments) Evaluate the expression
void	export(ExpressionPresenter out) Diagnostic print of expression structure.
ExpressionCompiler	getExpressionCompiler() Return the compiler of the KeyFn expression
boolean	getInternal()
KeyManager	getKeyManager()
NamespaceResolver	getNamespaceResolver()
int	getSpecialProperties(Expression[] arguments) Get the static properties of this expression (other than its type).
StructuredQName	getStaticKeyName() Get the key name, if known statically.
KeyDefinitionSet	getStaticKeySet()
static Expression	internalKeyCall(KeyManager keyManager, KeyDefinitionSet keySet, String name, Expression value, Expression doc, RetainedStaticContext rsc) Factory method to create an internal call on key() with a known key definition

Methods inherited from class net.sf.saxon.functions.SystemFunction

equals, exportAttributes, getArity, getCardinality, getContextNode, getDescription, getDetails, getErrorCodeForTypeErrors, getFunctionItemType, getFunctionName, getIntegerBounds, getOperandRoles, getRequiredType, getResultItemType, getResultItemType, getRetainedStaticContext, getStaticBaseUriString, getStreamingAdjunct, importAttributes, makeCall, makeFunction, makeFunctionCall, makeOptimizedFunctionCall, resultIfEmpty, setArity, setDetails, setRetainedStaticContext, supplyTypeInformation, typeCheckCaller

Methods inherited from class net.sf.saxon.functions.AbstractFunction

atomize, deepEquals, effectiveBooleanValue, getStringValue, getStringValueCS, isArray, isMap, optimize, simplify, typeCheck

Methods inherited from class net.sf.saxon.om.AbstractItem

getLength, head, itemAt, iterate, reduce, subsequence

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.sf.saxon.om.Function

iterate

Methods inherited from interface net.sf.saxon.om.Item

head

Methods inherited from interface net.sf.saxon.om.GroundedValue

getLength, head, itemAt, reduce, subsequence

Constructor Detail

KeyFn

public KeyFn()

Method Detail

getStaticKeyName

public StructuredQName getStaticKeyName()

Get the key name, if known statically. If not known statically, return null.

Returns:

the key name if known, otherwise null

getStaticKeySet

public KeyDefinitionSet getStaticKeySet()

getKeyManager

public KeyManager getKeyManager()

getInternal

public boolean getInternal()

getNamespaceResolver

public NamespaceResolver getNamespaceResolver()

internalKeyCall

public static Expression internalKeyCall(KeyManager keyManager,
                         KeyDefinitionSet keySet,
                         String name,
                         Expression value,
                         Expression doc,
                         RetainedStaticContext rsc)

Factory method to create an internal call on key() with a known key definition

Parameters:

keySet - the set of KeyDefinitions (always a single KeyDefinition)

name - the name allocated to the key (first argument of the function)

value - the value being searched for (second argument of the function)

doc - the document being searched (third argument)

Returns:

a call on the key() function

getSpecialProperties

public int getSpecialProperties(Expression[] arguments)

Get the static properties of this expression (other than its type). The result is bit-signficant. These properties are used for optimizations. In general, if a property bit is set, it is true, but if it is unset, the value is unknown.

Overrides:

getSpecialProperties in class SystemFunction

Parameters:

arguments -

export

public void export(ExpressionPresenter out)

Diagnostic print of expression structure. The abstract expression tree is written to the supplied output destination.

Specified by:

export in interface Function

Overrides:

export in class SystemFunction

Parameters:

out -

getExpressionCompiler

public ExpressionCompiler getExpressionCompiler()

Return the compiler of the KeyFn expression

Overrides:

getExpressionCompiler in class SystemFunction

Returns:

the relevant ExpressionCompiler

call

public Sequence call(XPathContext context,
            Sequence[] arguments)
              throws XPathException

Evaluate the expression

Parameters:

context - the dynamic evaluation context

arguments - the values of the arguments, supplied as Sequences

Returns:

the result of the evaluation, in the form of a Sequence

Throws:

XPathException - if a dynamic error occurs during the evaluation of the expression