xpathInternals

xmlXPathSetError()

#define     xmlXPathSetError(ctxt, err)

Raises an error.

xmlXPathSetArityError()

#define     xmlXPathSetArityError(ctxt)

Raises an XPATH_INVALID_ARITY error.

xmlXPathSetTypeError()

#define     xmlXPathSetTypeError(ctxt)

Raises an XPATH_INVALID_TYPE error.

xmlXPathGetError()

#define     xmlXPathGetError(ctxt)

Get the error code of an XPath context.

xmlXPathCheckError()

#define     xmlXPathCheckError(ctxt)

Check if an XPath error was raised.

xmlXPathGetDocument()

#define     xmlXPathGetDocument(ctxt)

Get the document of an XPath context.

xmlXPathGetContextNode()

#define     xmlXPathGetContextNode(ctxt)

Get the context node of an XPath context.

xmlXPathPopBoolean ()

int         xmlXPathPopBoolean              (xmlXPathParserContextPtr ctxt);

Pops a boolean from the stack, handling conversion if needed. Check error with xmlXPathCheckError.

xmlXPathPopNumber ()

double      xmlXPathPopNumber               (xmlXPathParserContextPtr ctxt);

Pops a number from the stack, handling conversion if needed. Check error with xmlXPathCheckError.

xmlXPathPopString ()

xmlChar*    xmlXPathPopString               (xmlXPathParserContextPtr ctxt);

Pops a string from the stack, handling conversion if needed. Check error with xmlXPathCheckError.

xmlXPathPopNodeSet ()

xmlNodeSetPtr xmlXPathPopNodeSet            (xmlXPathParserContextPtr ctxt);

Pops a node-set from the stack, handling conversion if needed. Check error with xmlXPathCheckError.

xmlXPathPopExternal ()

void*       xmlXPathPopExternal             (xmlXPathParserContextPtr ctxt);

Pops an external object from the stack, handling conversion if needed. Check error with xmlXPathCheckError.

xmlXPathReturnBoolean()

#define     xmlXPathReturnBoolean(ctxt, val)

Pushes the boolean val on the context stack.

xmlXPathReturnTrue()

#define     xmlXPathReturnTrue(ctxt)

Pushes true on the context stack.

xmlXPathReturnFalse()

#define     xmlXPathReturnFalse(ctxt)

Pushes false on the context stack.

xmlXPathReturnNumber()

#define     xmlXPathReturnNumber(ctxt, val)

Pushes the double val on the context stack.

xmlXPathReturnString()

#define     xmlXPathReturnString(ctxt, str)

Pushes the string str on the context stack.

xmlXPathReturnEmptyString()

#define     xmlXPathReturnEmptyString(ctxt)

Pushes an empty string on the stack.

xmlXPathReturnNodeSet()

#define     xmlXPathReturnNodeSet(ctxt, ns)

Pushes the node-set ns on the context stack.

xmlXPathReturnEmptyNodeSet()

#define     xmlXPathReturnEmptyNodeSet(ctxt)

Pushes an empty node-set on the context stack.

xmlXPathReturnExternal()

#define     xmlXPathReturnExternal(ctxt, val)

Pushes user data on the context stack.

xmlXPathStackIsNodeSet()

#define     xmlXPathStackIsNodeSet(ctxt)

Check if the current value on the XPath stack is a node set or an XSLT value tree.

xmlXPathStackIsExternal()

#define     xmlXPathStackIsExternal(ctxt)

Checks if the current value on the XPath stack is an external object.

xmlXPathEmptyNodeSet()

#define     xmlXPathEmptyNodeSet(ns)

Empties a node-set.

CHECK_ERROR

#define     CHECK_ERROR

Macro to return from the function if an XPath error was detected.

CHECK_ERROR0

#define     CHECK_ERROR0

Macro to return 0 from the function if an XPath error was detected.

XP_ERROR()

#define     XP_ERROR(X)

Macro to raise an XPath error and return.

XP_ERROR0()

#define     XP_ERROR0(X)

Macro to raise an XPath error and return 0.

CHECK_TYPE()

#define     CHECK_TYPE(typeval)

Macro to check that the value on top of the XPath stack is of a given type.

CHECK_TYPE0()

#define     CHECK_TYPE0(typeval)

Macro to check that the value on top of the XPath stack is of a given type. Return(0) in case of failure

CHECK_ARITY()

#define     CHECK_ARITY(x)

Macro to check that the number of args passed to an XPath function matches.

CAST_TO_STRING

#define     CAST_TO_STRING

Macro to try to cast the value on the top of the XPath stack to a string.

CAST_TO_NUMBER

#define     CAST_TO_NUMBER

Macro to try to cast the value on the top of the XPath stack to a number.

CAST_TO_BOOLEAN

#define     CAST_TO_BOOLEAN

Macro to try to cast the value on the top of the XPath stack to a boolean.

xmlXPathVariableLookupFunc ()

xmlXPathObjectPtr (*xmlXPathVariableLookupFunc)
                                            (void *ctxt,
                                             const xmlChar *name,
                                             const xmlChar *ns_uri);

Prototype for callbacks used to plug variable lookup in the XPath engine.

xmlXPathRegisterVariableLookup ()

void        xmlXPathRegisterVariableLookup  (xmlXPathContextPtr ctxt,
                                             xmlXPathVariableLookupFunc f,
                                             void *data);

register an external mechanism to do variable lookup

xmlXPathFuncLookupFunc ()

xmlXPathFunction (*xmlXPathFuncLookupFunc)  (void *ctxt,
                                             const xmlChar *name,
                                             const xmlChar *ns_uri);

Prototype for callbacks used to plug function lookup in the XPath engine.

xmlXPathRegisterFuncLookup ()

void        xmlXPathRegisterFuncLookup      (xmlXPathContextPtr ctxt,
                                             xmlXPathFuncLookupFunc f,
                                             void *funcCtxt);

Registers an external mechanism to do function lookup.

xmlXPatherror ()

void        xmlXPatherror                   (xmlXPathParserContextPtr ctxt,
                                             const char *file,
                                             int line,
                                             int no);

Formats an error message.

xmlXPathDebugDumpObject ()

void        xmlXPathDebugDumpObject         (FILE *output,
                                             xmlXPathObjectPtr cur,
                                             int depth);

Dump the content of the object for debugging purposes

xmlXPathDebugDumpCompExpr ()

void        xmlXPathDebugDumpCompExpr       (FILE *output,
                                             xmlXPathCompExprPtr comp,
                                             int depth);

Dumps the tree of the compiled XPath expression.

xmlXPathNodeSetContains ()

int         xmlXPathNodeSetContains         (xmlNodeSetPtr cur,
                                             xmlNodePtr val);

checks whether cur contains val

xmlXPathDifference ()

xmlNodeSetPtr xmlXPathDifference            (xmlNodeSetPtr nodes1,
                                             xmlNodeSetPtr nodes2);

Implements the EXSLT - Sets difference() function: node-set set:difference (node-set, node-set)

xmlXPathIntersection ()

xmlNodeSetPtr xmlXPathIntersection          (xmlNodeSetPtr nodes1,
                                             xmlNodeSetPtr nodes2);

Implements the EXSLT - Sets intersection() function: node-set set:intersection (node-set, node-set)

xmlXPathDistinctSorted ()

xmlNodeSetPtr xmlXPathDistinctSorted        (xmlNodeSetPtr nodes);

Implements the EXSLT - Sets distinct() function: node-set set:distinct (node-set)

xmlXPathDistinct ()

xmlNodeSetPtr xmlXPathDistinct              (xmlNodeSetPtr nodes);

Implements the EXSLT - Sets distinct() function: node-set set:distinct (node-set) nodes is sorted by document order, then exslSetsDistinctSorted is called with the sorted node-set

xmlXPathHasSameNodes ()

int         xmlXPathHasSameNodes            (xmlNodeSetPtr nodes1,
                                             xmlNodeSetPtr nodes2);

Implements the EXSLT - Sets has-same-nodes function: boolean set:has-same-node(node-set, node-set)

xmlXPathNodeLeadingSorted ()

xmlNodeSetPtr xmlXPathNodeLeadingSorted     (xmlNodeSetPtr nodes,
                                             xmlNodePtr node);

Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set)

xmlXPathLeadingSorted ()

xmlNodeSetPtr xmlXPathLeadingSorted         (xmlNodeSetPtr nodes1,
                                             xmlNodeSetPtr nodes2);

Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set)

xmlXPathNodeLeading ()

xmlNodeSetPtr xmlXPathNodeLeading           (xmlNodeSetPtr nodes,
                                             xmlNodePtr node);

Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set) nodes is sorted by document order, then exslSetsNodeLeadingSorted is called.

xmlXPathLeading ()

xmlNodeSetPtr xmlXPathLeading               (xmlNodeSetPtr nodes1,
                                             xmlNodeSetPtr nodes2);

Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set) nodes1 and nodes2 are sorted by document order, then exslSetsLeadingSorted is called.

xmlXPathNodeTrailingSorted ()

xmlNodeSetPtr xmlXPathNodeTrailingSorted    (xmlNodeSetPtr nodes,
                                             xmlNodePtr node);

Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set)

xmlXPathTrailingSorted ()

xmlNodeSetPtr xmlXPathTrailingSorted        (xmlNodeSetPtr nodes1,
                                             xmlNodeSetPtr nodes2);

Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set)

xmlXPathNodeTrailing ()

xmlNodeSetPtr xmlXPathNodeTrailing          (xmlNodeSetPtr nodes,
                                             xmlNodePtr node);

Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set) nodes is sorted by document order, then xmlXPathNodeTrailingSorted is called.

xmlXPathTrailing ()

xmlNodeSetPtr xmlXPathTrailing              (xmlNodeSetPtr nodes1,
                                             xmlNodeSetPtr nodes2);

Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set) nodes1 and nodes2 are sorted by document order, then xmlXPathTrailingSorted is called.

xmlXPathRegisterNs ()

int         xmlXPathRegisterNs              (xmlXPathContextPtr ctxt,
                                             const xmlChar *prefix,
                                             const xmlChar *ns_uri);

Register a new namespace. If ns_uri is NULL it unregisters the namespace

xmlXPathNsLookup ()

const xmlChar* xmlXPathNsLookup             (xmlXPathContextPtr ctxt,
                                             const xmlChar *prefix);

Search in the namespace declaration array of the context for the given namespace name associated to the given prefix

xmlXPathRegisteredNsCleanup ()

void        xmlXPathRegisteredNsCleanup     (xmlXPathContextPtr ctxt);

Cleanup the XPath context data associated to registered variables

xmlXPathRegisterFunc ()

int         xmlXPathRegisterFunc            (xmlXPathContextPtr ctxt,
                                             const xmlChar *name,
                                             xmlXPathFunction f);

Register a new function. If f is NULL it unregisters the function

xmlXPathRegisterFuncNS ()

int         xmlXPathRegisterFuncNS          (xmlXPathContextPtr ctxt,
                                             const xmlChar *name,
                                             const xmlChar *ns_uri,
                                             xmlXPathFunction f);

Register a new function. If f is NULL it unregisters the function

xmlXPathRegisterVariable ()

int         xmlXPathRegisterVariable        (xmlXPathContextPtr ctxt,
                                             const xmlChar *name,
                                             xmlXPathObjectPtr value);

Register a new variable value. If value is NULL it unregisters the variable

xmlXPathRegisterVariableNS ()

int         xmlXPathRegisterVariableNS      (xmlXPathContextPtr ctxt,
                                             const xmlChar *name,
                                             const xmlChar *ns_uri,
                                             xmlXPathObjectPtr value);

Register a new variable value. If value is NULL it unregisters the variable

xmlXPathFunctionLookup ()

xmlXPathFunction xmlXPathFunctionLookup     (xmlXPathContextPtr ctxt,
                                             const xmlChar *name);

Search in the Function array of the context for the given function.

xmlXPathFunctionLookupNS ()

xmlXPathFunction xmlXPathFunctionLookupNS   (xmlXPathContextPtr ctxt,
                                             const xmlChar *name,
                                             const xmlChar *ns_uri);

Search in the Function array of the context for the given function.

xmlXPathRegisteredFuncsCleanup ()

void        xmlXPathRegisteredFuncsCleanup  (xmlXPathContextPtr ctxt);

Cleanup the XPath context data associated to registered functions

xmlXPathVariableLookup ()

xmlXPathObjectPtr xmlXPathVariableLookup    (xmlXPathContextPtr ctxt,
                                             const xmlChar *name);

Search in the Variable array of the context for the given variable value.

xmlXPathVariableLookupNS ()

xmlXPathObjectPtr xmlXPathVariableLookupNS  (xmlXPathContextPtr ctxt,
                                             const xmlChar *name,
                                             const xmlChar *ns_uri);

Search in the Variable array of the context for the given variable value.

xmlXPathRegisteredVariablesCleanup ()

void        xmlXPathRegisteredVariablesCleanup
                                            (xmlXPathContextPtr ctxt);

Cleanup the XPath context data associated to registered variables

xmlXPathNewParserContext ()

xmlXPathParserContextPtr xmlXPathNewParserContext
                                            (const xmlChar *str,
                                             xmlXPathContextPtr ctxt);

Create a new xmlXPathParserContext

xmlXPathIdFunction ()

void        xmlXPathIdFunction              (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the id() XPath function node-set id(object) The id function selects elements by their unique ID (see [5.2.1 Unique IDs]). When the argument to id is of type node-set, then the result is the union of the result of applying id to the string value of each of the nodes in the argument node-set. When the argument to id is of any other type, the argument is converted to a string as if by a call to the string function; the string is split into a whitespace-separated list of tokens (whitespace is any sequence of characters matching the production S); the result is a node-set containing the elements in the same document as the context node that have a unique ID equal to any of the tokens in the list.

xmlXPathLocalNameFunction ()

void        xmlXPathLocalNameFunction       (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the local-name() XPath function string local-name(node-set?) The local-name function returns a string containing the local part of the name of the node in the argument node-set that is first in document order. If the node-set is empty or the first node has no name, an empty string is returned. If the argument is omitted it defaults to the context node.

xmlXPathNamespaceURIFunction ()

void        xmlXPathNamespaceURIFunction    (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the namespace-uri() XPath function string namespace-uri(node-set?) The namespace-uri function returns a string containing the namespace URI of the expanded name of the node in the argument node-set that is first in document order. If the node-set is empty, the first node has no name, or the expanded name has no namespace URI, an empty string is returned. If the argument is omitted it defaults to the context node.

xmlXPathStringFunction ()

void        xmlXPathStringFunction          (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the string() XPath function string string(object?) he string function converts an object to a string as follows: - A node-set is converted to a string by returning the value of the node in the node-set that is first in document order. If the node-set is empty, an empty string is returned. - A number is converted to a string as follows + NaN is converted to the string NaN + positive zero is converted to the string 0 + negative zero is converted to the string 0 + positive infinity is converted to the string Infinity + negative infinity is converted to the string -Infinity + if the number is an integer, the number is represented in decimal form as a Number with no decimal point and no leading zeros, preceded by a minus sign (-) if the number is negative + otherwise, the number is represented in decimal form as a Number including a decimal point with at least one digit before the decimal point and at least one digit after the decimal point, preceded by a minus sign (-) if the number is negative; there must be no leading zeros before the decimal point apart possibly from the one required digit immediately before the decimal point; beyond the one required digit after the decimal point there must be as many, but only as many, more digits as are needed to uniquely distinguish the number from all other IEEE 754 numeric values. - The boolean false value is converted to the string false. The boolean true value is converted to the string true.

If the argument is omitted, it defaults to a node-set with the context node as its only member.

xmlXPathStringLengthFunction ()

void        xmlXPathStringLengthFunction    (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the string-length() XPath function number string-length(string?) The string-length returns the number of characters in the string (see [3.6 Strings]). If the argument is omitted, it defaults to the context node converted to a string, in other words the value of the context node.

xmlXPathConcatFunction ()

void        xmlXPathConcatFunction          (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the concat() XPath function string concat(string, string, string*) The concat function returns the concatenation of its arguments.

xmlXPathContainsFunction ()

void        xmlXPathContainsFunction        (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the contains() XPath function boolean contains(string, string) The contains function returns true if the first argument string contains the second argument string, and otherwise returns false.

xmlXPathStartsWithFunction ()

void        xmlXPathStartsWithFunction      (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the starts-with() XPath function boolean starts-with(string, string) The starts-with function returns true if the first argument string starts with the second argument string, and otherwise returns false.

xmlXPathSubstringFunction ()

void        xmlXPathSubstringFunction       (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the substring() XPath function string substring(string, number, number?) The substring function returns the substring of the first argument starting at the position specified in the second argument with length specified in the third argument. For example, substring("12345",2,3) returns "234". If the third argument is not specified, it returns the substring starting at the position specified in the second argument and continuing to the end of the string. For example, substring("12345",2) returns "2345". More precisely, each character in the string (see [3.6 Strings]) is considered to have a numeric position: the position of the first character is 1, the position of the second character is 2 and so on. The returned substring contains those characters for which the position of the character is greater than or equal to the second argument and, if the third argument is specified, less than the sum of the second and third arguments; the comparisons and addition used for the above follow the standard IEEE 754 rules. Thus: - substring("12345", 1.5, 2.6) returns "234" - substring("12345", 0, 3) returns "12" - substring("12345", 0 div 0, 3) returns "" - substring("12345", 1, 0 div 0) returns "" - substring("12345", -42, 1 div 0) returns "12345" - substring("12345", -1 div 0, 1 div 0) returns ""

xmlXPathSubstringBeforeFunction ()

void        xmlXPathSubstringBeforeFunction (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the substring-before() XPath function string substring-before(string, string) The substring-before function returns the substring of the first argument string that precedes the first occurrence of the second argument string in the first argument string, or the empty string if the first argument string does not contain the second argument string. For example, substring-before("1999/04/01","/") returns 1999.

xmlXPathSubstringAfterFunction ()

void        xmlXPathSubstringAfterFunction  (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the substring-after() XPath function string substring-after(string, string) The substring-after function returns the substring of the first argument string that follows the first occurrence of the second argument string in the first argument string, or the empty stringi if the first argument string does not contain the second argument string. For example, substring-after("1999/04/01","/") returns 04/01, and substring-after("1999/04/01","19") returns 99/04/01.

xmlXPathNormalizeFunction ()

void        xmlXPathNormalizeFunction       (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the normalize-space() XPath function string normalize-space(string?) The normalize-space function returns the argument string with white space normalized by stripping leading and trailing whitespace and replacing sequences of whitespace characters by a single space. Whitespace characters are the same allowed by the S production in XML. If the argument is omitted, it defaults to the context node converted to a string, in other words the value of the context node.

xmlXPathTranslateFunction ()

void        xmlXPathTranslateFunction       (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the translate() XPath function string translate(string, string, string) The translate function returns the first argument string with occurrences of characters in the second argument string replaced by the character at the corresponding position in the third argument string. For example, translate("bar","abc","ABC") returns the string BAr. If there is a character in the second argument string with no character at a corresponding position in the third argument string (because the second argument string is longer than the third argument string), then occurrences of that character in the first argument string are removed. For example, translate("--aaa--","abc-","ABC")

xmlXPathNotFunction ()

void        xmlXPathNotFunction             (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the not() XPath function boolean not(boolean) The not function returns true if its argument is false, and false otherwise.

xmlXPathTrueFunction ()

void        xmlXPathTrueFunction            (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the true() XPath function boolean true()

xmlXPathFalseFunction ()

void        xmlXPathFalseFunction           (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the false() XPath function boolean false()

xmlXPathLangFunction ()

void        xmlXPathLangFunction            (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the lang() XPath function boolean lang(string) The lang function returns true or false depending on whether the language of the context node as specified by xml:lang attributes is the same as or is a sublanguage of the language specified by the argument string. The language of the context node is determined by the value of the xml:lang attribute on the context node, or, if the context node has no xml:lang attribute, by the value of the xml:lang attribute on the nearest ancestor of the context node that has an xml:lang attribute. If there is no such attribute, then lang

xmlXPathNumberFunction ()

void        xmlXPathNumberFunction          (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the number() XPath function number number(object?)

xmlXPathSumFunction ()

void        xmlXPathSumFunction             (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the sum() XPath function number sum(node-set) The sum function returns the sum of the values of the nodes in the argument node-set.

xmlXPathFloorFunction ()

void        xmlXPathFloorFunction           (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the floor() XPath function number floor(number) The floor function returns the largest (closest to positive infinity) number that is not greater than the argument and that is an integer.

xmlXPathCeilingFunction ()

void        xmlXPathCeilingFunction         (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the ceiling() XPath function number ceiling(number) The ceiling function returns the smallest (closest to negative infinity) number that is not less than the argument and that is an integer.

xmlXPathRoundFunction ()

void        xmlXPathRoundFunction           (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the round() XPath function number round(number) The round function returns the number that is closest to the argument and that is an integer. If there are two such numbers, then the one that is even is returned.

xmlXPathBooleanFunction ()

void        xmlXPathBooleanFunction         (xmlXPathParserContextPtr ctxt,
                                             int nargs);

Implement the boolean() XPath function boolean boolean(object) he boolean function converts its argument to a boolean as follows: - a number is true if and only if it is neither positive or negative zero nor NaN - a node-set is true if and only if it is non-empty - a string is true if and only if its length is non-zero

xmlXPathNodeSetFreeNs ()

void        xmlXPathNodeSetFreeNs           (xmlNsPtr ns);

Namespace node in libxml don't match the XPath semantic. In a node set the namespace nodes are duplicated and the next pointer is set to the parent node in the XPath semantic. Check if such a node need to be freed