net.sf.saxon.functions

Class CollatingFunctionFixed

java.lang.Object

net.sf.saxon.om.AbstractItem

net.sf.saxon.functions.AbstractFunction

net.sf.saxon.functions.SystemFunction

net.sf.saxon.functions.CollatingFunctionFixed

All Implemented Interfaces:

PullEvent, Callable, Function, GroundedValue, Item, Sequence

Direct Known Subclasses:

CollationKeyFn, Compare, Contains, ContainsToken, DeepEqual, DistinctValues, EndsWith, IndexOf, Minimax, StartsWith, SubstringAfter, SubstringBefore

public abstract class CollatingFunctionFixed
extends SystemFunction

Abstract superclass for functions that take an optional collation argument, in which the collation is not present as an explicit argument, either because it was defaulted in the original function call, or because it has been bound during static analysis.

Constructor Summary

Constructors

Constructor and Description
CollatingFunctionFixed()

Method Summary

Methods

Modifier and Type	Method and Description
void	exportAttributes(ExpressionPresenter out) Export any context attributes held within the SystemFunction object.
AtomicComparer	getAtomicComparer(XPathContext context) During evaluation, get the pre-allocated atomic comparer if available, or allocate a new one otherwise
AtomicComparer	getPreAllocatedAtomicComparer() Get the pre-allocated atomic comparer, if available
StringCollator	getStringCollator() Get the collation if known statically, as a StringCollator object
void	importAttributes(Properties attributes) Import any attributes found in the export file, that is, any attributes output using the exportAttributes method
protected void	preAllocateComparer(AtomicType type0, AtomicType type1, StaticContext env, boolean NaNequalsNaN) During static analysis, if types are known and the collation is known, pre-allocate a comparer for comparing atomic values.
void	setCollationName(String collationName)
void	setRetainedStaticContext(RetainedStaticContext retainedStaticContext) Set the static context in which the function operates, for use with functions whose result depends on the static context

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

equals, export, getArity, getCardinality, getContextNode, getDescription, getDetails, getErrorCodeForTypeErrors, getExpressionCompiler, getFunctionItemType, getFunctionName, getIntegerBounds, getOperandRoles, getRequiredType, getResultItemType, getResultItemType, getRetainedStaticContext, getSpecialProperties, getStaticBaseUriString, getStreamingAdjunct, makeCall, makeFunction, makeFunctionCall, makeOptimizedFunctionCall, resultIfEmpty, setArity, setDetails, 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

call, 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

CollatingFunctionFixed

public CollatingFunctionFixed()

Method Detail

getStringCollator

public StringCollator getStringCollator()

Get the collation if known statically, as a StringCollator object

Returns:

a StringCollator. Return null if the collation is not known statically.

setRetainedStaticContext

public void setRetainedStaticContext(RetainedStaticContext retainedStaticContext)

Description copied from class: SystemFunction

Set the static context in which the function operates, for use with functions whose result depends on the static context

Overrides:

setRetainedStaticContext in class SystemFunction

Parameters:

retainedStaticContext - the retained static context

setCollationName

public void setCollationName(String collationName)
                      throws XPathException

Throws:

XPathException

preAllocateComparer

protected void preAllocateComparer(AtomicType type0,
                       AtomicType type1,
                       StaticContext env,
                       boolean NaNequalsNaN)

During static analysis, if types are known and the collation is known, pre-allocate a comparer for comparing atomic values. Called by some collating functions during type-checking

Parameters:

type0 - the type of the first comparand

type1 - the type of the second comparand

env - the static context

NaNequalsNaN - true if two NaN values are to be considered equal

getPreAllocatedAtomicComparer

public AtomicComparer getPreAllocatedAtomicComparer()

Get the pre-allocated atomic comparer, if available

Returns:

the preallocated atomic comparer, or null

getAtomicComparer

public AtomicComparer getAtomicComparer(XPathContext context)

During evaluation, get the pre-allocated atomic comparer if available, or allocate a new one otherwise

Parameters:

context - the dynamic evaluation context

Returns:

the pre-allocated comparer if one is available; otherwise, a newly allocated one, using the specified StringCollator for comparing strings

exportAttributes

public void exportAttributes(ExpressionPresenter out)

Description copied from class: SystemFunction

Export any context attributes held within the SystemFunction object. The implementation will normally make one or more calls on out.emitAttribute(name, value).

Overrides:

exportAttributes in class SystemFunction

Parameters:

out - the export destination

importAttributes

public void importAttributes(Properties attributes)
                      throws XPathException

Description copied from class: SystemFunction

Import any attributes found in the export file, that is, any attributes output using the exportAttributes method

Overrides:

importAttributes in class SystemFunction

Parameters:

attributes - the attributes, as a properties object

Throws:

XPathException