MXmlEngXPathExtensionFunction Class Reference

#include <xml/dom/xmlengxpathextensionfunction.h>

class MXmlEngXPathExtensionFunction

Detailed Description

Provides an interface for an object to participate in the evaluation of XPath expression via a XPath function call.

Objects that implement the MXmlEngXPathExtensionFunction interface can be registered in a XmlEngXPathConfiguration object for global action (across all evaluations globally).

See also: XmlEngXPathConfiguration::AddExtensionFunctionL()

When the extension function is no longer required, it must be deregistered by calling XmlEngXPathConfiguration::RemoveExtensionFunction().

Member Enumeration Documentation

Enum TXmlEngEvaluationStatus

Evaluation status

EnumeratorValueDescription
ESucceeded

Evaluation was accomplished successfully

EError

An exceptional condition occurs

EInvalidArgumentType

Type of argument does not match function specification

EInvalidArgumentNumber

Number of arguments do not match function specification

Member Function Documentation

Evaluate ( MXmlEngXPathEvaluationContext * )

TXmlEngEvaluationStatus Evaluate(MXmlEngXPathEvaluationContext *aEvalCtxt)[pure virtual]

Called to evaluate the extension function.

This function is called only if simple arity constraints (min/max number of arguments) are satisfied. The implementation of this function may need to check further that the types of arguments and their positions in the function call match function-specific requirements.

ParameterDescription
aEvalCtxtEvaluation context, which contains data about arguments and provides a number of methods for setting the result of the extension function.

Returns: ESucceeded if evaluation success, otherwise one of the errors defined in TXmlEngEvaluationStatus.

MaxArity ( )

TInt MaxArity()[inline, virtual]

Gets the maximum number of arguments the function can take.

Returns: The maximum number of arguments or -1 if unbounded

MinArity ( )

TInt MinArity()[inline, virtual]

Gets the minimum number of arguments the function can take.

Returns: Minimum number of arguments