Blame doc/html/libxml-xpath.html

Packit Service a31ea6
Packit Service a31ea6
Packit Service a31ea6
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="SHORTCUT ICON" href="/favicon.ico" /><style type="text/css">
Packit Service a31ea6
TD {font-family: Verdana,Arial,Helvetica}
Packit Service a31ea6
BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
Packit Service a31ea6
H1 {font-family: Verdana,Arial,Helvetica}
Packit Service a31ea6
H2 {font-family: Verdana,Arial,Helvetica}
Packit Service a31ea6
H3 {font-family: Verdana,Arial,Helvetica}
Packit Service a31ea6
A:link, A:visited, A:active { text-decoration: underline }
Packit Service a31ea6
</style><style type="text/css">
Packit Service a31ea6
      div.deprecated pre.programlisting {border-style: double;border-color:red}
Packit Service a31ea6
      pre.programlisting {border-style: double;background: #EECFA1}
Packit Service a31ea6
    </style><title>Module xpath from libxml2</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000">
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module xpath from libxml2

<center>API Menu</center>
<form action="../search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form>
<center>API Indexes</center>
<center>Related links</center>

API for the XML Path Language implementation XML Path Language implementation XPath is a language for addressing parts of an XML document, designed to be used by both XSLT and XPointer

Table of Contents

#define XML_XPATH_CHECKNS
#define XML_XPATH_NOVAR
#define xmlXPathNodeSetGetLength
#define xmlXPathNodeSetIsEmpty
#define xmlXPathNodeSetItem
Structure xmlNodeSet
struct _xmlNodeSet
Packit Service a31ea6
Typedef xmlNodeSet * xmlNodeSetPtr
Packit Service a31ea6
Structure xmlXPathAxis
struct _xmlXPathAxis
Packit Service a31ea6
Typedef xmlXPathAxis * xmlXPathAxisPtr
Packit Service a31ea6
Structure xmlXPathCompExpr
struct _xmlXPathCompExpr
Packit Service a31ea6
The content of this structure is not made public by the API.
Packit Service a31ea6
Typedef xmlXPathCompExpr * xmlXPathCompExprPtr
Packit Service a31ea6
Structure xmlXPathContext
struct _xmlXPathContext
Packit Service a31ea6
Typedef xmlXPathContext * xmlXPathContextPtr
Packit Service a31ea6
Enum xmlXPathError
Packit Service a31ea6
Typedef xmlXPathFunct * xmlXPathFuncPtr
Packit Service a31ea6
Structure xmlXPathFunct
struct _xmlXPathFunct
Packit Service a31ea6
Structure xmlXPathObject
struct _xmlXPathObject
Packit Service a31ea6
Typedef xmlXPathObject * xmlXPathObjectPtr
Packit Service a31ea6
Enum xmlXPathObjectType
Packit Service a31ea6
Structure xmlXPathParserContext
struct _xmlXPathParserContext
Packit Service a31ea6
Typedef xmlXPathParserContext * xmlXPathParserContextPtr
Packit Service a31ea6
Structure xmlXPathType
struct _xmlXPathType
Packit Service a31ea6
Typedef xmlXPathType * xmlXPathTypePtr
Packit Service a31ea6
Structure xmlXPathVariable
struct _xmlXPathVariable
Packit Service a31ea6
Typedef xmlXPathVariable * xmlXPathVariablePtr
Packit Service a31ea6
Function type: xmlXPathAxisFunc
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathAxisFunc	(xmlXPathParserContextPtr ctxt, 
xmlXPathObjectPtr cur)
Packit Service a31ea6
Packit Service a31ea6
double	xmlXPathCastBooleanToNumber	(int val)
Packit Service a31ea6
xmlChar *	xmlXPathCastBooleanToString	(int val)
Packit Service a31ea6
int	xmlXPathCastNodeSetToBoolean	(xmlNodeSetPtr ns)
Packit Service a31ea6
double	xmlXPathCastNodeSetToNumber	(xmlNodeSetPtr ns)
Packit Service a31ea6
xmlChar *	xmlXPathCastNodeSetToString	(xmlNodeSetPtr ns)
Packit Service a31ea6
double	xmlXPathCastNodeToNumber	(xmlNodePtr node)
Packit Service a31ea6
xmlChar *	xmlXPathCastNodeToString	(xmlNodePtr node)
Packit Service a31ea6
int	xmlXPathCastNumberToBoolean	(double val)
Packit Service a31ea6
xmlChar *	xmlXPathCastNumberToString	(double val)
Packit Service a31ea6
int	xmlXPathCastStringToBoolean	(const xmlChar * val)
Packit Service a31ea6
double	xmlXPathCastStringToNumber	(const xmlChar * val)
Packit Service a31ea6
int	xmlXPathCastToBoolean		(xmlXPathObjectPtr val)
Packit Service a31ea6
double	xmlXPathCastToNumber		(xmlXPathObjectPtr val)
Packit Service a31ea6
xmlChar *	xmlXPathCastToString	(xmlXPathObjectPtr val)
Packit Service a31ea6
int	xmlXPathCmpNodes		(xmlNodePtr node1, 
xmlNodePtr node2)
Packit Service a31ea6
xmlXPathCompExprPtr	xmlXPathCompile	(const xmlChar * str)
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathCompiledEval	(xmlXPathCompExprPtr comp, 
xmlXPathContextPtr ctx)
Packit Service a31ea6
int	xmlXPathCompiledEvalToBoolean	(xmlXPathCompExprPtr comp, 
xmlXPathContextPtr ctxt)
Packit Service a31ea6
int	xmlXPathContextSetCache		(xmlXPathContextPtr ctxt, 
int active,
int value,
int options)
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathConvertBoolean	(xmlXPathObjectPtr val)
Packit Service a31ea6
Function type: xmlXPathConvertFunc
Packit Service a31ea6
int	xmlXPathConvertFunc		(xmlXPathObjectPtr obj, 
int type)
Packit Service a31ea6
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathConvertNumber	(xmlXPathObjectPtr val)
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathConvertString	(xmlXPathObjectPtr val)
Packit Service a31ea6
xmlXPathCompExprPtr	xmlXPathCtxtCompile	(xmlXPathContextPtr ctxt, 
const xmlChar * str)
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathEval	(const xmlChar * str, 
xmlXPathContextPtr ctx)
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathEvalExpression	(const xmlChar * str, 
xmlXPathContextPtr ctxt)
Packit Service a31ea6
Function type: xmlXPathEvalFunc
Packit Service a31ea6
void	xmlXPathEvalFunc		(xmlXPathParserContextPtr ctxt, 
int nargs)
Packit Service a31ea6
Packit Service a31ea6
int	xmlXPathEvalPredicate		(xmlXPathContextPtr ctxt, 
xmlXPathObjectPtr res)
Packit Service a31ea6
void	xmlXPathFreeCompExpr		(xmlXPathCompExprPtr comp)
Packit Service a31ea6
void	xmlXPathFreeContext		(xmlXPathContextPtr ctxt)
Packit Service a31ea6
void	xmlXPathFreeNodeSet		(xmlNodeSetPtr obj)
Packit Service a31ea6
void	xmlXPathFreeNodeSetList		(xmlXPathObjectPtr obj)
Packit Service a31ea6
void	xmlXPathFreeObject		(xmlXPathObjectPtr obj)
Packit Service a31ea6
Function type: xmlXPathFuncLookupFunc
Packit Service a31ea6
xmlXPathFunction	xmlXPathFuncLookupFunc	(void * ctxt, 
const xmlChar * name,
const xmlChar * ns_uri)
Packit Service a31ea6
Packit Service a31ea6
Function type: xmlXPathFunction
Packit Service a31ea6
void	xmlXPathFunction		(xmlXPathParserContextPtr ctxt, 
int nargs)
Packit Service a31ea6
Packit Service a31ea6
void	xmlXPathInit			(void)
Packit Service a31ea6
int	xmlXPathIsInf			(double val)
Packit Service a31ea6
int	xmlXPathIsNaN			(double val)
Packit Service a31ea6
xmlXPathContextPtr	xmlXPathNewContext	(xmlDocPtr doc)
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathNodeEval	(xmlNodePtr node, 
const xmlChar * str,
xmlXPathContextPtr ctx)
Packit Service a31ea6
xmlNodeSetPtr	xmlXPathNodeSetCreate	(xmlNodePtr val)
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathObjectCopy	(xmlXPathObjectPtr val)
Packit Service a31ea6
long	xmlXPathOrderDocElems		(xmlDocPtr doc)
Packit Service a31ea6
int	xmlXPathSetContextNode		(xmlNodePtr node, 
xmlXPathContextPtr ctx)
Packit Service a31ea6
Function type: xmlXPathVariableLookupFunc
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathVariableLookupFunc	(void * ctxt, 
const xmlChar * name,
const xmlChar * ns_uri)
Packit Service a31ea6
Packit Service a31ea6

Description

Packit Service a31ea6

Macro: XML_XPATH_CHECKNS

#define XML_XPATH_CHECKNS

check namespaces at compilation

Packit Service a31ea6

Macro: XML_XPATH_NOVAR

#define XML_XPATH_NOVAR

forbid variables in expression

Packit Service a31ea6

Macro: xmlXPathNodeSetGetLength

#define xmlXPathNodeSetGetLength

Implement a functionality similar to the DOM NodeList.length. Returns the number of nodes in the node-set.

Packit Service a31ea6

Macro: xmlXPathNodeSetIsEmpty

#define xmlXPathNodeSetIsEmpty

Checks whether @ns is empty or not. Returns %TRUE if @ns is an empty node-set.

Packit Service a31ea6

Macro: xmlXPathNodeSetItem

#define xmlXPathNodeSetItem

Implements a functionality similar to the DOM NodeList.item(). Returns the xmlNodePtr at the given @index in @ns or NULL if @index is out of range (0 to length-1)

Packit Service a31ea6

Structure xmlNodeSet

Structure xmlNodeSet
struct _xmlNodeSet {
Packit Service a31ea6
    int	nodeNr	: number of nodes in the set
Packit Service a31ea6
    int	nodeMax	: size of the array as allocated
Packit Service a31ea6
    xmlNodePtr *	nodeTab	: array of nodes in no particular order @
Packit Service a31ea6
}

Structure xmlXPathAxis

Structure xmlXPathAxis
struct _xmlXPathAxis {
Packit Service a31ea6
    const xmlChar *	name	: the axis name
Packit Service a31ea6
    xmlXPathAxisFunc	func	: the search function
Packit Service a31ea6
}

Structure xmlXPathCompExpr

Structure xmlXPathCompExpr
struct _xmlXPathCompExpr {
Packit Service a31ea6
The content of this structure is not made public by the API.
Packit Service a31ea6
}

Structure xmlXPathContext

Structure xmlXPathContext
struct _xmlXPathContext {
Packit Service a31ea6
    xmlDocPtr	doc	: The current document
Packit Service a31ea6
    xmlNodePtr	node	: The current node
Packit Service a31ea6
    int	nb_variables_unused	: unused (hash table)
Packit Service a31ea6
    int	max_variables_unused	: unused (hash table)
Packit Service a31ea6
    xmlHashTablePtr	varHash	: Hash table of defined variables
Packit Service a31ea6
    int	nb_types	: number of defined types
Packit Service a31ea6
    int	max_types	: max number of types
Packit Service a31ea6
    xmlXPathTypePtr	types	: Array of defined types
Packit Service a31ea6
    int	nb_funcs_unused	: unused (hash table)
Packit Service a31ea6
    int	max_funcs_unused	: unused (hash table)
Packit Service a31ea6
    xmlHashTablePtr	funcHash	: Hash table of defined funcs
Packit Service a31ea6
    int	nb_axis	: number of defined axis
Packit Service a31ea6
    int	max_axis	: max number of axis
Packit Service a31ea6
    xmlXPathAxisPtr	axis	: Array of defined axis the namespace nod
Packit Service a31ea6
    xmlNsPtr *	namespaces	: Array of namespaces
Packit Service a31ea6
    int	nsNr	: number of namespace in scope
Packit Service a31ea6
    void *	user	: function to free extra variables
Packit Service a31ea6
    int	contextSize	: the context size
Packit Service a31ea6
    int	proximityPosition	: the proximity position extra stuff for
Packit Service a31ea6
    int	xptr	: is this an XPointer context?
Packit Service a31ea6
    xmlNodePtr	here	: for here()
Packit Service a31ea6
    xmlNodePtr	origin	: for origin() the set of namespace decla
Packit Service a31ea6
    xmlHashTablePtr	nsHash	: The namespaces hash table
Packit Service a31ea6
    xmlXPathVariableLookupFunc	varLookupFunc	: variable lookup func
Packit Service a31ea6
    void *	varLookupData	: variable lookup data Possibility to lin
Packit Service a31ea6
    void *	extra	: needed for XSLT The function name and U
Packit Service a31ea6
    const xmlChar *	function
Packit Service a31ea6
    const xmlChar *	functionURI	: function lookup function and data
Packit Service a31ea6
    xmlXPathFuncLookupFunc	funcLookupFunc	: function lookup func
Packit Service a31ea6
    void *	funcLookupData	: function lookup data temporary namespac
Packit Service a31ea6
    xmlNsPtr *	tmpNsList	: Array of namespaces
Packit Service a31ea6
    int	tmpNsNr	: number of namespaces in scope error rep
Packit Service a31ea6
    void *	userData	: user specific data block
Packit Service a31ea6
    xmlStructuredErrorFunc	error	: the callback in case of errors
Packit Service a31ea6
    xmlError	lastError	: the last error
Packit Service a31ea6
    xmlNodePtr	debugNode	: the source node XSLT dictionary
Packit Service a31ea6
    xmlDictPtr	dict	: dictionary if any
Packit Service a31ea6
    int	flags	: flags to control compilation Cache for
Packit Service a31ea6
    void *	cache
Packit Service a31ea6
}

Enum xmlXPathError

Enum xmlXPathError {
Packit Service a31ea6
    XPATH_EXPRESSION_OK = 0
Packit Service a31ea6
    XPATH_NUMBER_ERROR = 1
Packit Service a31ea6
    XPATH_UNFINISHED_LITERAL_ERROR = 2
Packit Service a31ea6
    XPATH_START_LITERAL_ERROR = 3
Packit Service a31ea6
    XPATH_VARIABLE_REF_ERROR = 4
Packit Service a31ea6
    XPATH_UNDEF_VARIABLE_ERROR = 5
Packit Service a31ea6
    XPATH_INVALID_PREDICATE_ERROR = 6
Packit Service a31ea6
    XPATH_EXPR_ERROR = 7
Packit Service a31ea6
    XPATH_UNCLOSED_ERROR = 8
Packit Service a31ea6
    XPATH_UNKNOWN_FUNC_ERROR = 9
Packit Service a31ea6
    XPATH_INVALID_OPERAND = 10
Packit Service a31ea6
    XPATH_INVALID_TYPE = 11
Packit Service a31ea6
    XPATH_INVALID_ARITY = 12
Packit Service a31ea6
    XPATH_INVALID_CTXT_SIZE = 13
Packit Service a31ea6
    XPATH_INVALID_CTXT_POSITION = 14
Packit Service a31ea6
    XPATH_MEMORY_ERROR = 15
Packit Service a31ea6
    XPTR_SYNTAX_ERROR = 16
Packit Service a31ea6
    XPTR_RESOURCE_ERROR = 17
Packit Service a31ea6
    XPTR_SUB_RESOURCE_ERROR = 18
Packit Service a31ea6
    XPATH_UNDEF_PREFIX_ERROR = 19
Packit Service a31ea6
    XPATH_ENCODING_ERROR = 20
Packit Service a31ea6
    XPATH_INVALID_CHAR_ERROR = 21
Packit Service a31ea6
    XPATH_INVALID_CTXT = 22
Packit Service a31ea6
    XPATH_STACK_ERROR = 23
Packit Service a31ea6
    XPATH_FORBID_VARIABLE_ERROR = 24
Packit Service a31ea6
}
Packit Service a31ea6

Structure xmlXPathFunct

Structure xmlXPathFunct
struct _xmlXPathFunct {
Packit Service a31ea6
    const xmlChar *	name	: the function name
Packit Service a31ea6
    xmlXPathEvalFunc	func	: the evaluation function
Packit Service a31ea6
}

Structure xmlXPathObject

Structure xmlXPathObject
struct _xmlXPathObject {
Packit Service a31ea6
    xmlXPathObjectType	type
Packit Service a31ea6
    xmlNodeSetPtr	nodesetval
Packit Service a31ea6
    int	boolval
Packit Service a31ea6
    double	floatval
Packit Service a31ea6
    xmlChar *	stringval
Packit Service a31ea6
    void *	user
Packit Service a31ea6
    int	index
Packit Service a31ea6
    void *	user2
Packit Service a31ea6
    int	index2
Packit Service a31ea6
}

Enum xmlXPathObjectType

Enum xmlXPathObjectType {
Packit Service a31ea6
    XPATH_UNDEFINED = 0
Packit Service a31ea6
    XPATH_NODESET = 1
Packit Service a31ea6
    XPATH_BOOLEAN = 2
Packit Service a31ea6
    XPATH_NUMBER = 3
Packit Service a31ea6
    XPATH_STRING = 4
Packit Service a31ea6
    XPATH_POINT = 5
Packit Service a31ea6
    XPATH_RANGE = 6
Packit Service a31ea6
    XPATH_LOCATIONSET = 7
Packit Service a31ea6
    XPATH_USERS = 8
Packit Service a31ea6
    XPATH_XSLT_TREE = 9 : An XSLT value tree, non modifiable
Packit Service a31ea6
}
Packit Service a31ea6

Structure xmlXPathParserContext

Structure xmlXPathParserContext
struct _xmlXPathParserContext {
Packit Service a31ea6
    const xmlChar *	cur	: the current char being parsed
Packit Service a31ea6
    const xmlChar *	base	: the full expression
Packit Service a31ea6
    int	error	: error code
Packit Service a31ea6
    xmlXPathContextPtr	context	: the evaluation context
Packit Service a31ea6
    xmlXPathObjectPtr	value	: the current value
Packit Service a31ea6
    int	valueNr	: number of values stacked
Packit Service a31ea6
    int	valueMax	: max number of values stacked
Packit Service a31ea6
    xmlXPathObjectPtr *	valueTab	: stack of values
Packit Service a31ea6
    xmlXPathCompExprPtr	comp	: the precompiled expression
Packit Service a31ea6
    int	xptr	: it this an XPointer expression
Packit Service a31ea6
    xmlNodePtr	ancestor	: used for walking preceding axis
Packit Service a31ea6
    int	valueFrame	: used to limit Pop on the stack
Packit Service a31ea6
}

Structure xmlXPathType

Structure xmlXPathType
struct _xmlXPathType {
Packit Service a31ea6
    const xmlChar *	name	: the type name
Packit Service a31ea6
    xmlXPathConvertFunc	func	: the conversion function
Packit Service a31ea6
}

Structure xmlXPathVariable

Structure xmlXPathVariable
struct _xmlXPathVariable {
Packit Service a31ea6
    const xmlChar *	name	: the variable name
Packit Service a31ea6
    xmlXPathObjectPtr	value	: the value
Packit Service a31ea6
}

Function type: xmlXPathAxisFunc

Function type: xmlXPathAxisFunc
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathAxisFunc	(xmlXPathParserContextPtr ctxt, 
xmlXPathObjectPtr cur)
Packit Service a31ea6

An axis traversal function. To traverse an axis, the engine calls the first time with cur == NULL and repeat until the function returns NULL indicating the end of the axis traversal.

<tt>ctxt</tt>:the XPath interpreter context
<tt>cur</tt>:the previous node being explored on that axis
<tt>Returns</tt>:the next node in that axis or NULL if at the end of the axis.

Packit Service a31ea6

Function: xmlXPathCastBooleanToNumber

double	xmlXPathCastBooleanToNumber	(int val)
Packit Service a31ea6

Converts a boolean to its number value

Packit Service a31ea6
<tt>val</tt>:a boolean
<tt>Returns</tt>:the number value

Function: xmlXPathCastBooleanToString

xmlChar *	xmlXPathCastBooleanToString	(int val)
Packit Service a31ea6

Converts a boolean to its string value.

Packit Service a31ea6
<tt>val</tt>:a boolean
<tt>Returns</tt>:a newly allocated string.

Function: xmlXPathCastNodeSetToBoolean

int	xmlXPathCastNodeSetToBoolean	(xmlNodeSetPtr ns)
Packit Service a31ea6

Converts a node-set to its boolean value

Packit Service a31ea6
<tt>ns</tt>:a node-set
<tt>Returns</tt>:the boolean value

Function: xmlXPathCastNodeSetToNumber

double	xmlXPathCastNodeSetToNumber	(xmlNodeSetPtr ns)
Packit Service a31ea6

Converts a node-set to its number value

Packit Service a31ea6
<tt>ns</tt>:a node-set
<tt>Returns</tt>:the number value

Function: xmlXPathCastNodeSetToString

xmlChar *	xmlXPathCastNodeSetToString	(xmlNodeSetPtr ns)
Packit Service a31ea6

Converts a node-set to its string value.

Packit Service a31ea6
<tt>ns</tt>:a node-set
<tt>Returns</tt>:a newly allocated string.

Function: xmlXPathCastNodeToNumber

double	xmlXPathCastNodeToNumber	(xmlNodePtr node)
Packit Service a31ea6

Converts a node to its number value

Packit Service a31ea6
<tt>node</tt>:a node
<tt>Returns</tt>:the number value

Function: xmlXPathCastNodeToString

xmlChar *	xmlXPathCastNodeToString	(xmlNodePtr node)
Packit Service a31ea6

Converts a node to its string value.

Packit Service a31ea6
<tt>node</tt>:a node
<tt>Returns</tt>:a newly allocated string.

Function: xmlXPathCastNumberToBoolean

int	xmlXPathCastNumberToBoolean	(double val)
Packit Service a31ea6

Converts a number to its boolean value

Packit Service a31ea6
<tt>val</tt>:a number
<tt>Returns</tt>:the boolean value

Function: xmlXPathCastNumberToString

xmlChar *	xmlXPathCastNumberToString	(double val)
Packit Service a31ea6

Converts a number to its string value.

Packit Service a31ea6
<tt>val</tt>:a number
<tt>Returns</tt>:a newly allocated string.

Function: xmlXPathCastStringToBoolean

int	xmlXPathCastStringToBoolean	(const xmlChar * val)
Packit Service a31ea6

Converts a string to its boolean value

Packit Service a31ea6
<tt>val</tt>:a string
<tt>Returns</tt>:the boolean value

Function: xmlXPathCastStringToNumber

double	xmlXPathCastStringToNumber	(const xmlChar * val)
Packit Service a31ea6

Converts a string to its number value

Packit Service a31ea6
<tt>val</tt>:a string
<tt>Returns</tt>:the number value

Function: xmlXPathCastToBoolean

int	xmlXPathCastToBoolean		(xmlXPathObjectPtr val)
Packit Service a31ea6

Converts an XPath object to its boolean value

Packit Service a31ea6
<tt>val</tt>:an XPath object
<tt>Returns</tt>:the boolean value

Function: xmlXPathCastToNumber

double	xmlXPathCastToNumber		(xmlXPathObjectPtr val)
Packit Service a31ea6

Converts an XPath object to its number value

Packit Service a31ea6
<tt>val</tt>:an XPath object
<tt>Returns</tt>:the number value

Function: xmlXPathCastToString

xmlChar *	xmlXPathCastToString	(xmlXPathObjectPtr val)
Packit Service a31ea6

Converts an existing object to its string() equivalent

Packit Service a31ea6
<tt>val</tt>:an XPath object
<tt>Returns</tt>:the allocated string value of the object, NULL in case of error. It's up to the caller to free the string memory with xmlFree().

Function: xmlXPathCmpNodes

int	xmlXPathCmpNodes		(xmlNodePtr node1, 
xmlNodePtr node2)
Packit Service a31ea6

Compare two nodes w.r.t document order

Packit Service a31ea6
<tt>node1</tt>:the first node
<tt>node2</tt>:the second node
<tt>Returns</tt>:-2 in case of error 1 if first point < second point, 0 if it's the same node, -1 otherwise

Function: xmlXPathCompile

xmlXPathCompExprPtr	xmlXPathCompile	(const xmlChar * str)
Packit Service a31ea6

Compile an XPath expression

Packit Service a31ea6
<tt>str</tt>:the XPath expression
<tt>Returns</tt>:the xmlXPathCompExprPtr resulting from the compilation or NULL. the caller has to free the object.

Function: xmlXPathCompiledEval

xmlXPathObjectPtr	xmlXPathCompiledEval	(xmlXPathCompExprPtr comp, 
xmlXPathContextPtr ctx)
Packit Service a31ea6

Evaluate the Precompiled XPath expression in the given context.

Packit Service a31ea6
<tt>comp</tt>:the compiled XPath expression
<tt>ctx</tt>:the XPath context
<tt>Returns</tt>:the xmlXPathObjectPtr resulting from the evaluation or NULL. the caller has to free the object.

Function: xmlXPathCompiledEvalToBoolean

int	xmlXPathCompiledEvalToBoolean	(xmlXPathCompExprPtr comp, 
xmlXPathContextPtr ctxt)
Packit Service a31ea6

Applies the XPath boolean() function on the result of the given compiled expression.

Packit Service a31ea6
<tt>comp</tt>:the compiled XPath expression
<tt>ctxt</tt>:the XPath context
<tt>Returns</tt>:1 if the expression evaluated to true, 0 if to false and -1 in API and internal errors.

Function: xmlXPathContextSetCache

int	xmlXPathContextSetCache		(xmlXPathContextPtr ctxt, 
int active,
int value,
int options)
Packit Service a31ea6

Creates/frees an object cache on the XPath context. If activates XPath objects (xmlXPathObject) will be cached internally to be reused. @options: 0: This will set the XPath object caching: @value: This will set the maximum number of XPath objects to be cached per slot There are 5 slots for: node-set, string, number, boolean, and misc objects. Use <0 for the default number (100). Other values for @options have currently no effect.

Packit Service a31ea6
<tt>ctxt</tt>:the XPath context
<tt>active</tt>:enables/disables (creates/frees) the cache
<tt>value</tt>:a value with semantics dependant on @options
<tt>options</tt>:options (currently only the value 0 is used)
<tt>Returns</tt>:0 if the setting succeeded, and -1 on API or internal errors.

Function: xmlXPathConvertBoolean

xmlXPathObjectPtr	xmlXPathConvertBoolean	(xmlXPathObjectPtr val)
Packit Service a31ea6

Converts an existing object to its boolean() equivalent

Packit Service a31ea6
<tt>val</tt>:an XPath object
<tt>Returns</tt>:the new object, the old one is freed (or the operation is done directly on @val)

Function type: xmlXPathConvertFunc

Function type: xmlXPathConvertFunc
Packit Service a31ea6
int	xmlXPathConvertFunc		(xmlXPathObjectPtr obj, 
int type)
Packit Service a31ea6

A conversion function is associated to a type and used to cast the new type to primitive values.

<tt>obj</tt>:an XPath object
<tt>type</tt>:the number of the target type
<tt>Returns</tt>:-1 in case of error, 0 otherwise

Packit Service a31ea6

Function: xmlXPathConvertNumber

xmlXPathObjectPtr	xmlXPathConvertNumber	(xmlXPathObjectPtr val)
Packit Service a31ea6

Converts an existing object to its number() equivalent

Packit Service a31ea6
<tt>val</tt>:an XPath object
<tt>Returns</tt>:the new object, the old one is freed (or the operation is done directly on @val)

Function: xmlXPathConvertString

xmlXPathObjectPtr	xmlXPathConvertString	(xmlXPathObjectPtr val)
Packit Service a31ea6

Converts an existing object to its string() equivalent

Packit Service a31ea6
<tt>val</tt>:an XPath object
<tt>Returns</tt>:the new object, the old one is freed (or the operation is done directly on @val)

Function: xmlXPathCtxtCompile

xmlXPathCompExprPtr	xmlXPathCtxtCompile	(xmlXPathContextPtr ctxt, 
const xmlChar * str)
Packit Service a31ea6

Compile an XPath expression

Packit Service a31ea6
<tt>ctxt</tt>:an XPath context
<tt>str</tt>:the XPath expression
<tt>Returns</tt>:the xmlXPathCompExprPtr resulting from the compilation or NULL. the caller has to free the object.

Function: xmlXPathEval

xmlXPathObjectPtr	xmlXPathEval	(const xmlChar * str, 
xmlXPathContextPtr ctx)
Packit Service a31ea6

Evaluate the XPath Location Path in the given context.

Packit Service a31ea6
<tt>str</tt>:the XPath expression
<tt>ctx</tt>:the XPath context
<tt>Returns</tt>:the xmlXPathObjectPtr resulting from the evaluation or NULL. the caller has to free the object.

Function: xmlXPathEvalExpression

xmlXPathObjectPtr	xmlXPathEvalExpression	(const xmlChar * str, 
xmlXPathContextPtr ctxt)
Packit Service a31ea6

Alias for xmlXPathEval().

Packit Service a31ea6
<tt>str</tt>:the XPath expression
<tt>ctxt</tt>:the XPath context
<tt>Returns</tt>:the xmlXPathObjectPtr resulting from the evaluation or NULL. the caller has to free the object.

Function type: xmlXPathEvalFunc

Function type: xmlXPathEvalFunc
Packit Service a31ea6
void	xmlXPathEvalFunc		(xmlXPathParserContextPtr ctxt, 
int nargs)
Packit Service a31ea6

An XPath evaluation function, the parameters are on the XPath context stack.

<tt>ctxt</tt>:an XPath parser context
<tt>nargs</tt>:the number of arguments passed to the function

Packit Service a31ea6

Function: xmlXPathEvalPredicate

int	xmlXPathEvalPredicate		(xmlXPathContextPtr ctxt, 
xmlXPathObjectPtr res)
Packit Service a31ea6

Evaluate a predicate result for the current node. A PredicateExpr is evaluated by evaluating the Expr and converting the result to a boolean. If the result is a number, the result will be converted to true if the number is equal to the position of the context node in the context node list (as returned by the position function) and will be converted to false otherwise; if the result is not a number, then the result will be converted as if by a call to the boolean function.

Packit Service a31ea6
<tt>ctxt</tt>:the XPath context
<tt>res</tt>:the Predicate Expression evaluation result
<tt>Returns</tt>:1 if predicate is true, 0 otherwise

Function: xmlXPathFreeCompExpr

void	xmlXPathFreeCompExpr		(xmlXPathCompExprPtr comp)
Packit Service a31ea6

Free up the memory allocated by @comp

Packit Service a31ea6
<tt>comp</tt>:an XPATH comp

Function: xmlXPathFreeContext

void	xmlXPathFreeContext		(xmlXPathContextPtr ctxt)
Packit Service a31ea6

Free up an xmlXPathContext

Packit Service a31ea6
<tt>ctxt</tt>:the context to free

Function: xmlXPathFreeNodeSet

void	xmlXPathFreeNodeSet		(xmlNodeSetPtr obj)
Packit Service a31ea6

Free the NodeSet compound (not the actual nodes !).

Packit Service a31ea6
<tt>obj</tt>:the xmlNodeSetPtr to free

Function: xmlXPathFreeNodeSetList

void	xmlXPathFreeNodeSetList		(xmlXPathObjectPtr obj)
Packit Service a31ea6

Free up the xmlXPathObjectPtr @obj but don't deallocate the objects in the list contrary to xmlXPathFreeObject().

Packit Service a31ea6
<tt>obj</tt>:an existing NodeSetList object

Function: xmlXPathFreeObject

void	xmlXPathFreeObject		(xmlXPathObjectPtr obj)
Packit Service a31ea6

Free up an xmlXPathObjectPtr object.

Packit Service a31ea6
<tt>obj</tt>:the object to free

Function type: xmlXPathFuncLookupFunc

Function type: xmlXPathFuncLookupFunc
Packit Service a31ea6
xmlXPathFunction	xmlXPathFuncLookupFunc	(void * ctxt, 
const xmlChar * name,
const xmlChar * ns_uri)
Packit Service a31ea6

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

<tt>ctxt</tt>:an XPath context
<tt>name</tt>:name of the function
<tt>ns_uri</tt>:the namespace name hosting this function
<tt>Returns</tt>:the XPath function or NULL if not found.

Packit Service a31ea6

Function type: xmlXPathFunction

Function type: xmlXPathFunction
Packit Service a31ea6
void	xmlXPathFunction		(xmlXPathParserContextPtr ctxt, 
int nargs)
Packit Service a31ea6

An XPath function. The arguments (if any) are popped out from the context stack and the result is pushed on the stack.

<tt>ctxt</tt>:the XPath interprestation context
<tt>nargs</tt>:the number of arguments

Packit Service a31ea6

Function: xmlXPathInit

void	xmlXPathInit			(void)
Packit Service a31ea6

Initialize the XPath environment

Packit Service a31ea6

Function: xmlXPathIsInf

int	xmlXPathIsInf			(double val)
Packit Service a31ea6

Provides a portable isinf() function to detect whether a double is a +Infinite or -Infinite. Based on trio code http://sourceforge.net/projects/ctrio/

Packit Service a31ea6
<tt>val</tt>:a double value
<tt>Returns</tt>:1 vi the value is +Infinite, -1 if -Infinite, 0 otherwise

Function: xmlXPathIsNaN

int	xmlXPathIsNaN			(double val)
Packit Service a31ea6

Provides a portable isnan() function to detect whether a double is a NotaNumber. Based on trio code http://sourceforge.net/projects/ctrio/

Packit Service a31ea6
<tt>val</tt>:a double value
<tt>Returns</tt>:1 if the value is a NaN, 0 otherwise

Function: xmlXPathNewContext

xmlXPathContextPtr	xmlXPathNewContext	(xmlDocPtr doc)
Packit Service a31ea6

Create a new xmlXPathContext

Packit Service a31ea6
<tt>doc</tt>:the XML document
<tt>Returns</tt>:the xmlXPathContext just allocated. The caller will need to free it.

Function: xmlXPathNodeEval

xmlXPathObjectPtr	xmlXPathNodeEval	(xmlNodePtr node, 
const xmlChar * str,
xmlXPathContextPtr ctx)
Packit Service a31ea6

Evaluate the XPath Location Path in the given context. The node 'node' is set as the context node. The context node is not restored.

Packit Service a31ea6
<tt>node</tt>:the node to to use as the context node
<tt>str</tt>:the XPath expression
<tt>ctx</tt>:the XPath context
<tt>Returns</tt>:the xmlXPathObjectPtr resulting from the evaluation or NULL. the caller has to free the object.

Function: xmlXPathNodeSetCreate

xmlNodeSetPtr	xmlXPathNodeSetCreate	(xmlNodePtr val)
Packit Service a31ea6

Create a new xmlNodeSetPtr of type double and of value @val

Packit Service a31ea6
<tt>val</tt>:an initial xmlNodePtr, or NULL
<tt>Returns</tt>:the newly created object.

Function: xmlXPathObjectCopy

xmlXPathObjectPtr	xmlXPathObjectCopy	(xmlXPathObjectPtr val)
Packit Service a31ea6

allocate a new copy of a given object

Packit Service a31ea6
<tt>val</tt>:the original object
<tt>Returns</tt>:the newly created object.

Function: xmlXPathOrderDocElems

long	xmlXPathOrderDocElems		(xmlDocPtr doc)
Packit Service a31ea6

Call this routine to speed up XPath computation on static documents. This stamps all the element nodes with the document order Like for line information, the order is kept in the element->content field, the value stored is actually - the node number (starting at -1) to be able to differentiate from line numbers.

Packit Service a31ea6
<tt>doc</tt>:an input document
<tt>Returns</tt>:the number of elements found in the document or -1 in case of error.

Function: xmlXPathSetContextNode

int	xmlXPathSetContextNode		(xmlNodePtr node, 
xmlXPathContextPtr ctx)
Packit Service a31ea6

Sets 'node' as the context node. The node must be in the same document as that associated with the context.

Packit Service a31ea6
<tt>node</tt>:the node to to use as the context node
<tt>ctx</tt>:the XPath context
<tt>Returns</tt>:-1 in case of error or 0 if successful

Function type: xmlXPathVariableLookupFunc

Function type: xmlXPathVariableLookupFunc
Packit Service a31ea6
xmlXPathObjectPtr	xmlXPathVariableLookupFunc	(void * ctxt, 
const xmlChar * name,
const xmlChar * ns_uri)
Packit Service a31ea6

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

<tt>ctxt</tt>:an XPath context
<tt>name</tt>:name of the variable
<tt>ns_uri</tt>:the namespace name hosting this variable
<tt>Returns</tt>:the XPath object value or NULL if not found.

Packit Service a31ea6

Daniel Veillard

</body></html>