xpath.h 6.73 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14
/*
 * xpath.c: interface for XML Path Language implementation
 *
 * Reference: W3C Working Draft 5 July 1999
 *            http://www.w3.org/Style/XSL/Group/1999/07/xpath-19990705.html
 *
 * See COPYRIGHT for the status of this software
 *
 * Author: Daniel.Veillard@w3.org
 */

#ifndef __XML_XPATH_H__
#define __XML_XPATH_H__

15
#include <libxml/tree.h>
Daniel Veillard's avatar
Daniel Veillard committed
16

17
#ifdef __cplusplus
18
extern "C" {
19
#endif
20

21 22 23 24
typedef struct _xmlXPathContext xmlXPathContext;
typedef xmlXPathContext *xmlXPathContextPtr;
typedef struct _xmlXPathParserContext xmlXPathParserContext;
typedef xmlXPathParserContext *xmlXPathParserContextPtr;
25

26 27 28
/*
 * A node-set (an unordered collection of nodes without duplicates) 
 */
29 30 31
typedef struct _xmlNodeSet xmlNodeSet;
typedef xmlNodeSet *xmlNodeSetPtr;
struct _xmlNodeSet {
32 33
    int nodeNr;			/* number of nodes in the set */
    int nodeMax;		/* size of the array as allocated */
34
    xmlNodePtr *nodeTab;	/* array of nodes in no particular order */
35
};
36 37 38 39 40 41 42 43

/*
 * An expression is evaluated to yield an object, which
 * has one of the following four basic types:
 *   - node-set
 *   - boolean
 *   - number
 *   - string
44 45
 *
 * @@ XPointer will add more types !
46 47 48 49 50 51 52
 */

#define XPATH_UNDEFINED	0
#define XPATH_NODESET	1
#define XPATH_BOOLEAN	2
#define XPATH_NUMBER	3
#define XPATH_STRING	4
53
#define XPATH_USERS	5
54

55 56 57
typedef struct _xmlXPathObject xmlXPathObject;
typedef xmlXPathObject *xmlXPathObjectPtr;
struct _xmlXPathObject {
58 59 60
    int type;
    xmlNodeSetPtr nodesetval;
    int boolval;
61
    double floatval;
62
    xmlChar *stringval;
63
    void *user;
64
};
65

66 67 68 69 70 71 72 73 74 75
/*
 * A conversion function is associated to a type and used to cast
 * the new type to primitive values.
 */
typedef int (*xmlXPathConvertFunc) (xmlXPathObjectPtr obj, int type);

/*
 * Extra type: a name and a conversion function.
 */

76 77 78
typedef struct _xmlXPathType xmlXPathType;
typedef xmlXPathType *xmlXPathTypePtr;
struct _xmlXPathType {
79
    const xmlChar         *name;		/* the type name */
80
    xmlXPathConvertFunc func;		/* the conversion function */
81
};
82 83 84 85 86

/*
 * Extra variable: a name and a value.
 */

87 88 89
typedef struct _xmlXPathVariable xmlXPathVariable;
typedef xmlXPathVariable *xmlXPathVariablePtr;
struct _xmlXPathVariable {
90
    const xmlChar       *name;		/* the variable name */
91
    xmlXPathObjectPtr value;		/* the value */
92
};
93 94 95 96 97 98 99 100 101 102 103

/*
 * an evaluation function, the parameters are on the context stack
 */

typedef void (*xmlXPathEvalFunc)(xmlXPathParserContextPtr ctxt, int nargs);

/*
 * Extra function: a name and a evaluation function.
 */

104 105 106
typedef struct _xmlXPathFunct xmlXPathFunct;
typedef xmlXPathFunct *xmlXPathFuncPtr;
struct _xmlXPathFunct {
107
    const xmlChar      *name;		/* the function name */
108
    xmlXPathEvalFunc func;		/* the evaluation function */
109
};
110 111 112 113 114 115 116 117 118 119 120 121 122 123

/*
 * 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.
 */

typedef xmlXPathObjectPtr (*xmlXPathAxisFunc)	(xmlXPathParserContextPtr ctxt,
						 xmlXPathObjectPtr cur);

/*
 * Extra axis: a name and an axis function.
 */

124 125 126
typedef struct _xmlXPathAxis xmlXPathAxis;
typedef xmlXPathAxis *xmlXPathAxisPtr;
struct _xmlXPathAxis {
127
    const xmlChar      *name;		/* the axis name */
128
    xmlXPathAxisFunc func;		/* the search function */
129
};
130

131 132 133 134 135 136 137 138 139 140
/* 
 * Expression evaluation occurs with respect to a context.
 * he context consists of:
 *    - a node (the context node) 
 *    - a node list (the context node list) 
 *    - a set of variable bindings 
 *    - a function library 
 *    - the set of namespace declarations in scope for the expression 
 */

141
struct _xmlXPathContext {
142 143 144
    xmlDocPtr doc;			/* The current document */
    xmlNodePtr node;			/* The current node */
    xmlNodeSetPtr nodelist;		/* The current node list */
145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162

    int nb_variables;			/* number of defined variables */
    int max_variables;			/* max number of variables */
    xmlXPathVariablePtr *variables;	/* Array of defined variables */

    int nb_types;			/* number of defined types */
    int max_types;			/* max number of types */
    xmlXPathTypePtr *types;		/* Array of defined types */

    int nb_funcs;			/* number of defined funcs */
    int max_funcs;			/* max number of funcs */
    xmlXPathFuncPtr *funcs;		/* Array of defined funcs */

    int nb_axis;			/* number of defined axis */
    int max_axis;			/* max number of axis */
    xmlXPathAxisPtr *axis;		/* Array of defined axis */

    /* Namespace traversal should be implemented with user */
163 164
    xmlNsPtr *namespaces;		/* The namespaces lookup */
    int nsNr;				/* the current Namespace index */
165
    void *user;				/* user defined extra info */
166
};
167 168 169 170 171

/*
 * An XPath parser context, it contains pure parsing informations,
 * an xmlXPathContext, and the stack of objects.
 */
172
struct _xmlXPathParserContext {
173 174
    const xmlChar *cur;			/* the current char being parsed */
    const xmlChar *base;			/* the full expression */
175 176 177 178 179 180 181 182

    int error;				/* error code */

    xmlXPathContextPtr  context;	/* the evaluation context */
    xmlXPathObjectPtr     value;	/* the current value */
    int                 valueNr;	/* number of values stacked */
    int                valueMax;	/* max number of values stacked */
    xmlXPathObjectPtr *valueTab;	/* stack of values */
183
};
184 185 186 187 188 189 190 191 192 193 194 195 196 197 198

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

typedef void (*xmlXPathFunction) (xmlXPathParserContextPtr ctxt, int nargs);

/************************************************************************
 *									*
 *			Public API					*
 *									*
 ************************************************************************/

199 200 201 202
/**
 * Registering extensions to the expression language
 */
/* TODO */ int	   xmlXPathRegisterType		(xmlXPathContextPtr ctxt,
203
						 const xmlChar *name,
204 205
                                                 xmlXPathConvertFunc f);
/* TODO */ int	   xmlXPathRegisterAxis		(xmlXPathContextPtr ctxt,
206
						 const xmlChar *name,
207 208
						 xmlXPathAxisFunc f);
/* TODO */ int	   xmlXPathRegisterFunc		(xmlXPathContextPtr ctxt,
209
						 const xmlChar *name,
210 211
						 xmlXPathFunction f);
/* TODO */ int	   xmlXPathRegisterVariable	(xmlXPathContextPtr ctxt,
212
						 const xmlChar *name,
213 214 215 216 217 218
						 xmlXPathObject value);

/**
 * Evaluation functions.
 */
xmlXPathContextPtr xmlXPathNewContext		(xmlDocPtr doc);
219
void		   xmlXPathFreeContext		(xmlXPathContextPtr ctxt);
220
xmlXPathObjectPtr  xmlXPathEval			(const xmlChar *str,
221 222
						 xmlXPathContextPtr ctxt);
void		   xmlXPathFreeObject		(xmlXPathObjectPtr obj);
223
xmlXPathObjectPtr  xmlXPathEvalExpression	(const xmlChar *str,
224
						 xmlXPathContextPtr ctxt);
225 226 227
xmlNodeSetPtr	   xmlXPathNodeSetCreate	(xmlNodePtr val);
void		   xmlXPathFreeNodeSetList	(xmlXPathObjectPtr obj);
void		   xmlXPathFreeNodeSet		(xmlNodeSetPtr obj);
228

229 230 231
#ifdef __cplusplus
}
#endif
232
#endif /* ! __XML_XPATH_H__ */