blob: dcd524343e35c3c9811a03564ac5ae14d07a5b03 [file] [log] [blame]
Owen Taylor3473f882001-02-23 17:55:21 +00001/*
Daniel Veillardbe586972003-11-18 20:56:51 +00002 * Summary: internal interfaces for XML Path Language implementation
3 * Description: internal interfaces for XML Path Language implementation
4 * used to build new modules on top of XPath like XPointer and
5 * XSLT
Owen Taylor3473f882001-02-23 17:55:21 +00006 *
Daniel Veillardbe586972003-11-18 20:56:51 +00007 * Copy: See Copyright for the status of this software.
Owen Taylor3473f882001-02-23 17:55:21 +00008 *
Daniel Veillardbe586972003-11-18 20:56:51 +00009 * Author: Daniel Veillard
Owen Taylor3473f882001-02-23 17:55:21 +000010 */
11
12#ifndef __XML_XPATH_INTERNALS_H__
13#define __XML_XPATH_INTERNALS_H__
14
Daniel Veillard017b1082001-06-21 11:20:21 +000015#include <libxml/xmlversion.h>
Owen Taylor3473f882001-02-23 17:55:21 +000016#include <libxml/xpath.h>
17
Daniel Veillarda2351322004-06-27 12:08:10 +000018#ifdef LIBXML_XPATH_ENABLED
19
Owen Taylor3473f882001-02-23 17:55:21 +000020#ifdef __cplusplus
21extern "C" {
22#endif
23
24/************************************************************************
25 * *
26 * Helpers *
27 * *
28 ************************************************************************/
29
William M. Brack60f394e2003-11-16 06:25:42 +000030/*
Daniel Veillard8fcc4942001-07-17 20:07:33 +000031 * Many of these macros may later turn into functions. They
32 * shouldn't be used in #ifdef's preprocessor instructions.
33 */
Thomas Broyerf06a3d82001-07-16 04:52:57 +000034/**
35 * xmlXPathSetError:
36 * @ctxt: an XPath parser context
37 * @err: an xmlXPathError code
38 *
39 * Raises an error.
40 */
41#define xmlXPathSetError(ctxt, err) \
42 { xmlXPatherror((ctxt), __FILE__, __LINE__, (err)); \
Daniel Veillarda82b1822004-11-08 16:24:57 +000043 if ((ctxt) != NULL) (ctxt)->error = (err); }
Daniel Veillard8fcc4942001-07-17 20:07:33 +000044
Thomas Broyerf06a3d82001-07-16 04:52:57 +000045/**
46 * xmlXPathSetArityError:
47 * @ctxt: an XPath parser context
48 *
Daniel Veillard61f26172002-03-12 18:46:39 +000049 * Raises an XPATH_INVALID_ARITY error.
Thomas Broyerf06a3d82001-07-16 04:52:57 +000050 */
51#define xmlXPathSetArityError(ctxt) \
52 xmlXPathSetError((ctxt), XPATH_INVALID_ARITY)
Daniel Veillard8fcc4942001-07-17 20:07:33 +000053
Thomas Broyerf06a3d82001-07-16 04:52:57 +000054/**
55 * xmlXPathSetTypeError:
56 * @ctxt: an XPath parser context
57 *
Daniel Veillard61f26172002-03-12 18:46:39 +000058 * Raises an XPATH_INVALID_TYPE error.
Thomas Broyerf06a3d82001-07-16 04:52:57 +000059 */
60#define xmlXPathSetTypeError(ctxt) \
61 xmlXPathSetError((ctxt), XPATH_INVALID_TYPE)
Daniel Veillard8fcc4942001-07-17 20:07:33 +000062
Thomas Broyerf06a3d82001-07-16 04:52:57 +000063/**
64 * xmlXPathGetError:
65 * @ctxt: an XPath parser context
66 *
Daniel Veillard61f26172002-03-12 18:46:39 +000067 * Get the error code of an XPath context.
Daniel Veillard5e2dace2001-07-18 19:30:27 +000068 *
Daniel Veillard61f26172002-03-12 18:46:39 +000069 * Returns the context error.
Thomas Broyerf06a3d82001-07-16 04:52:57 +000070 */
71#define xmlXPathGetError(ctxt) ((ctxt)->error)
Daniel Veillard8fcc4942001-07-17 20:07:33 +000072
Thomas Broyerf06a3d82001-07-16 04:52:57 +000073/**
74 * xmlXPathCheckError:
75 * @ctxt: an XPath parser context
76 *
Daniel Veillard61f26172002-03-12 18:46:39 +000077 * Check if an XPath error was raised.
Daniel Veillard5e2dace2001-07-18 19:30:27 +000078 *
Thomas Broyerf06a3d82001-07-16 04:52:57 +000079 * Returns true if an error has been raised, false otherwise.
80 */
81#define xmlXPathCheckError(ctxt) ((ctxt)->error != XPATH_EXPRESSION_OK)
82
83/**
84 * xmlXPathGetDocument:
85 * @ctxt: an XPath parser context
86 *
Daniel Veillard61f26172002-03-12 18:46:39 +000087 * Get the document of an XPath context.
Daniel Veillard5e2dace2001-07-18 19:30:27 +000088 *
Daniel Veillard61f26172002-03-12 18:46:39 +000089 * Returns the context document.
Thomas Broyerf06a3d82001-07-16 04:52:57 +000090 */
91#define xmlXPathGetDocument(ctxt) ((ctxt)->context->doc)
Daniel Veillard8fcc4942001-07-17 20:07:33 +000092
Thomas Broyerf06a3d82001-07-16 04:52:57 +000093/**
94 * xmlXPathGetContextNode:
95 * @ctxt: an XPath parser context
96 *
Daniel Veillard61f26172002-03-12 18:46:39 +000097 * Get the context node of an XPath context.
Daniel Veillard5e2dace2001-07-18 19:30:27 +000098 *
Daniel Veillard61f26172002-03-12 18:46:39 +000099 * Returns the context node.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000100 */
101#define xmlXPathGetContextNode(ctxt) ((ctxt)->context->node)
102
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000103XMLPUBFUN int XMLCALL
104 xmlXPathPopBoolean (xmlXPathParserContextPtr ctxt);
105XMLPUBFUN double XMLCALL
106 xmlXPathPopNumber (xmlXPathParserContextPtr ctxt);
107XMLPUBFUN xmlChar * XMLCALL
108 xmlXPathPopString (xmlXPathParserContextPtr ctxt);
109XMLPUBFUN xmlNodeSetPtr XMLCALL
110 xmlXPathPopNodeSet (xmlXPathParserContextPtr ctxt);
111XMLPUBFUN void * XMLCALL
112 xmlXPathPopExternal (xmlXPathParserContextPtr ctxt);
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000113
114/**
115 * xmlXPathReturnBoolean:
116 * @ctxt: an XPath parser context
117 * @val: a boolean
118 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000119 * Pushes the boolean @val on the context stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000120 */
121#define xmlXPathReturnBoolean(ctxt, val) \
122 valuePush((ctxt), xmlXPathNewBoolean(val))
Daniel Veillard8fcc4942001-07-17 20:07:33 +0000123
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000124/**
125 * xmlXPathReturnTrue:
126 * @ctxt: an XPath parser context
127 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000128 * Pushes true on the context stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000129 */
130#define xmlXPathReturnTrue(ctxt) xmlXPathReturnBoolean((ctxt), 1)
Daniel Veillard8fcc4942001-07-17 20:07:33 +0000131
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000132/**
133 * xmlXPathReturnFalse:
134 * @ctxt: an XPath parser context
135 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000136 * Pushes false on the context stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000137 */
138#define xmlXPathReturnFalse(ctxt) xmlXPathReturnBoolean((ctxt), 0)
Daniel Veillard8fcc4942001-07-17 20:07:33 +0000139
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000140/**
141 * xmlXPathReturnNumber:
142 * @ctxt: an XPath parser context
143 * @val: a double
144 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000145 * Pushes the double @val on the context stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000146 */
147#define xmlXPathReturnNumber(ctxt, val) \
148 valuePush((ctxt), xmlXPathNewFloat(val))
Daniel Veillard8fcc4942001-07-17 20:07:33 +0000149
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000150/**
151 * xmlXPathReturnString:
152 * @ctxt: an XPath parser context
153 * @str: a string
154 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000155 * Pushes the string @str on the context stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000156 */
157#define xmlXPathReturnString(ctxt, str) \
William M. Brack09428a32003-12-20 09:20:39 +0000158 valuePush((ctxt), xmlXPathWrapString(str))
Daniel Veillard8fcc4942001-07-17 20:07:33 +0000159
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000160/**
161 * xmlXPathReturnEmptyString:
162 * @ctxt: an XPath parser context
163 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000164 * Pushes an empty string on the stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000165 */
166#define xmlXPathReturnEmptyString(ctxt) \
167 valuePush((ctxt), xmlXPathNewCString(""))
Daniel Veillard8fcc4942001-07-17 20:07:33 +0000168
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000169/**
170 * xmlXPathReturnNodeSet:
171 * @ctxt: an XPath parser context
172 * @ns: a node-set
173 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000174 * Pushes the node-set @ns on the context stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000175 */
176#define xmlXPathReturnNodeSet(ctxt, ns) \
177 valuePush((ctxt), xmlXPathWrapNodeSet(ns))
Daniel Veillard8fcc4942001-07-17 20:07:33 +0000178
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000179/**
180 * xmlXPathReturnEmptyNodeSet:
181 * @ctxt: an XPath parser context
182 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000183 * Pushes an empty node-set on the context stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000184 */
Daniel Veillard5344c602001-12-31 16:37:34 +0000185#define xmlXPathReturnEmptyNodeSet(ctxt) \
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000186 valuePush((ctxt), xmlXPathNewNodeSet(NULL))
Daniel Veillard8fcc4942001-07-17 20:07:33 +0000187
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000188/**
189 * xmlXPathReturnExternal:
190 * @ctxt: an XPath parser context
191 * @val: user data
192 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000193 * Pushes user data on the context stack.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000194 */
195#define xmlXPathReturnExternal(ctxt, val) \
196 valuePush((ctxt), xmlXPathWrapExternal(val))
197
198/**
199 * xmlXPathStackIsNodeSet:
200 * @ctxt: an XPath parser context
201 *
Daniel Veillard5e2dace2001-07-18 19:30:27 +0000202 * Check if the current value on the XPath stack is a node set or
Daniel Veillard61f26172002-03-12 18:46:39 +0000203 * an XSLT value tree.
Daniel Veillard5e2dace2001-07-18 19:30:27 +0000204 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000205 * Returns true if the current object on the stack is a node-set.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000206 */
207#define xmlXPathStackIsNodeSet(ctxt) \
208 (((ctxt)->value != NULL) \
209 && (((ctxt)->value->type == XPATH_NODESET) \
210 || ((ctxt)->value->type == XPATH_XSLT_TREE)))
211
212/**
Thomas Broyer47334c02001-10-07 16:41:52 +0000213 * xmlXPathStackIsExternal:
214 * @ctxt: an XPath parser context
215 *
216 * Checks if the current value on the XPath stack is an external
217 * object.
218 *
219 * Returns true if the current object on the stack is an external
Daniel Veillard61f26172002-03-12 18:46:39 +0000220 * object.
Thomas Broyer47334c02001-10-07 16:41:52 +0000221 */
222#define xmlXPathStackIsExternal(ctxt) \
223 ((ctxt->value != NULL) && (ctxt->value->type == XPATH_USERS))
224
225/**
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000226 * xmlXPathEmptyNodeSet:
227 * @ns: a node-set
228 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000229 * Empties a node-set.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000230 */
231#define xmlXPathEmptyNodeSet(ns) \
232 { while ((ns)->nodeNr > 0) (ns)->nodeTab[(ns)->nodeNr--] = NULL; }
233
Daniel Veillardbed7b052001-05-19 14:59:49 +0000234/**
235 * CHECK_ERROR:
236 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000237 * Macro to return from the function if an XPath error was detected.
Daniel Veillardbed7b052001-05-19 14:59:49 +0000238 */
Owen Taylor3473f882001-02-23 17:55:21 +0000239#define CHECK_ERROR \
240 if (ctxt->error != XPATH_EXPRESSION_OK) return
241
Daniel Veillardbed7b052001-05-19 14:59:49 +0000242/**
243 * CHECK_ERROR0:
244 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000245 * Macro to return 0 from the function if an XPath error was detected.
Daniel Veillardbed7b052001-05-19 14:59:49 +0000246 */
Owen Taylor3473f882001-02-23 17:55:21 +0000247#define CHECK_ERROR0 \
248 if (ctxt->error != XPATH_EXPRESSION_OK) return(0)
249
Daniel Veillardbed7b052001-05-19 14:59:49 +0000250/**
251 * XP_ERROR:
252 * @X: the error code
253 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000254 * Macro to raise an XPath error and return.
Daniel Veillardbed7b052001-05-19 14:59:49 +0000255 */
Owen Taylor3473f882001-02-23 17:55:21 +0000256#define XP_ERROR(X) \
Daniel Veillardd96f6d32003-10-07 21:25:12 +0000257 { xmlXPathErr(ctxt, X); return; }
Owen Taylor3473f882001-02-23 17:55:21 +0000258
Daniel Veillardbed7b052001-05-19 14:59:49 +0000259/**
260 * XP_ERROR0:
261 * @X: the error code
262 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000263 * Macro to raise an XPath error and return 0.
Daniel Veillardbed7b052001-05-19 14:59:49 +0000264 */
Owen Taylor3473f882001-02-23 17:55:21 +0000265#define XP_ERROR0(X) \
Daniel Veillardd96f6d32003-10-07 21:25:12 +0000266 { xmlXPathErr(ctxt, X); return(0); }
Owen Taylor3473f882001-02-23 17:55:21 +0000267
Daniel Veillardbed7b052001-05-19 14:59:49 +0000268/**
269 * CHECK_TYPE:
270 * @typeval: the XPath type
271 *
272 * Macro to check that the value on top of the XPath stack is of a given
273 * type.
274 */
Owen Taylor3473f882001-02-23 17:55:21 +0000275#define CHECK_TYPE(typeval) \
276 if ((ctxt->value == NULL) || (ctxt->value->type != typeval)) \
277 XP_ERROR(XPATH_INVALID_TYPE)
278
Daniel Veillardbed7b052001-05-19 14:59:49 +0000279/**
Daniel Veillardf06307e2001-07-03 10:35:50 +0000280 * CHECK_TYPE0:
281 * @typeval: the XPath type
282 *
283 * Macro to check that the value on top of the XPath stack is of a given
Daniel Veillard61f26172002-03-12 18:46:39 +0000284 * type. Return(0) in case of failure
Daniel Veillardf06307e2001-07-03 10:35:50 +0000285 */
286#define CHECK_TYPE0(typeval) \
287 if ((ctxt->value == NULL) || (ctxt->value->type != typeval)) \
288 XP_ERROR0(XPATH_INVALID_TYPE)
289
290/**
Daniel Veillardbed7b052001-05-19 14:59:49 +0000291 * CHECK_ARITY:
292 * @x: the number of expected args
293 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000294 * Macro to check that the number of args passed to an XPath function matches.
Daniel Veillardbed7b052001-05-19 14:59:49 +0000295 */
Owen Taylor3473f882001-02-23 17:55:21 +0000296#define CHECK_ARITY(x) \
Daniel Veillarda82b1822004-11-08 16:24:57 +0000297 if (ctxt == NULL) return; \
Owen Taylor3473f882001-02-23 17:55:21 +0000298 if (nargs != (x)) \
299 XP_ERROR(XPATH_INVALID_ARITY);
300
Daniel Veillardbed7b052001-05-19 14:59:49 +0000301/**
302 * CAST_TO_STRING:
303 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000304 * Macro to try to cast the value on the top of the XPath stack to a string.
Daniel Veillardbed7b052001-05-19 14:59:49 +0000305 */
Owen Taylor3473f882001-02-23 17:55:21 +0000306#define CAST_TO_STRING \
307 if ((ctxt->value != NULL) && (ctxt->value->type != XPATH_STRING)) \
308 xmlXPathStringFunction(ctxt, 1);
309
Daniel Veillardbed7b052001-05-19 14:59:49 +0000310/**
311 * CAST_TO_NUMBER:
312 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000313 * Macro to try to cast the value on the top of the XPath stack to a number.
Daniel Veillardbed7b052001-05-19 14:59:49 +0000314 */
Owen Taylor3473f882001-02-23 17:55:21 +0000315#define CAST_TO_NUMBER \
316 if ((ctxt->value != NULL) && (ctxt->value->type != XPATH_NUMBER)) \
317 xmlXPathNumberFunction(ctxt, 1);
318
Daniel Veillardbed7b052001-05-19 14:59:49 +0000319/**
320 * CAST_TO_BOOLEAN:
321 *
Daniel Veillard61f26172002-03-12 18:46:39 +0000322 * Macro to try to cast the value on the top of the XPath stack to a boolean.
Daniel Veillardbed7b052001-05-19 14:59:49 +0000323 */
Owen Taylor3473f882001-02-23 17:55:21 +0000324#define CAST_TO_BOOLEAN \
325 if ((ctxt->value != NULL) && (ctxt->value->type != XPATH_BOOLEAN)) \
326 xmlXPathBooleanFunction(ctxt, 1);
327
328/*
Daniel Veillard61f26172002-03-12 18:46:39 +0000329 * Variable Lookup forwarding.
Owen Taylor3473f882001-02-23 17:55:21 +0000330 */
Owen Taylor3473f882001-02-23 17:55:21 +0000331
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000332XMLPUBFUN void XMLCALL
333 xmlXPathRegisterVariableLookup (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000334 xmlXPathVariableLookupFunc f,
Daniel Veillardcbaf3992001-12-31 16:16:02 +0000335 void *data);
Owen Taylor3473f882001-02-23 17:55:21 +0000336
337/*
Daniel Veillard61f26172002-03-12 18:46:39 +0000338 * Function Lookup forwarding.
Thomas Broyerba4ad322001-07-26 16:55:21 +0000339 */
Thomas Broyerba4ad322001-07-26 16:55:21 +0000340
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000341XMLPUBFUN void XMLCALL
342 xmlXPathRegisterFuncLookup (xmlXPathContextPtr ctxt,
Thomas Broyerba4ad322001-07-26 16:55:21 +0000343 xmlXPathFuncLookupFunc f,
344 void *funcCtxt);
345
346/*
Daniel Veillard61f26172002-03-12 18:46:39 +0000347 * Error reporting.
Owen Taylor3473f882001-02-23 17:55:21 +0000348 */
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000349XMLPUBFUN void XMLCALL
350 xmlXPatherror (xmlXPathParserContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000351 const char *file,
352 int line,
353 int no);
354
Daniel Veillardd96f6d32003-10-07 21:25:12 +0000355XMLPUBFUN void XMLCALL
356 xmlXPathErr (xmlXPathParserContextPtr ctxt,
357 int error);
358
Daniel Veillarda9cce9c2003-09-29 13:20:24 +0000359#ifdef LIBXML_DEBUG_ENABLED
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000360XMLPUBFUN void XMLCALL
361 xmlXPathDebugDumpObject (FILE *output,
Owen Taylor3473f882001-02-23 17:55:21 +0000362 xmlXPathObjectPtr cur,
363 int depth);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000364XMLPUBFUN void XMLCALL
365 xmlXPathDebugDumpCompExpr(FILE *output,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000366 xmlXPathCompExprPtr comp,
367 int depth);
Daniel Veillarda9cce9c2003-09-29 13:20:24 +0000368#endif
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000369/**
Daniel Veillard61f26172002-03-12 18:46:39 +0000370 * NodeSet handling.
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000371 */
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000372XMLPUBFUN int XMLCALL
373 xmlXPathNodeSetContains (xmlNodeSetPtr cur,
Thomas Broyerf186c822001-07-31 23:30:37 +0000374 xmlNodePtr val);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000375XMLPUBFUN xmlNodeSetPtr XMLCALL
376 xmlXPathDifference (xmlNodeSetPtr nodes1,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000377 xmlNodeSetPtr nodes2);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000378XMLPUBFUN xmlNodeSetPtr XMLCALL
379 xmlXPathIntersection (xmlNodeSetPtr nodes1,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000380 xmlNodeSetPtr nodes2);
381
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000382XMLPUBFUN xmlNodeSetPtr XMLCALL
383 xmlXPathDistinctSorted (xmlNodeSetPtr nodes);
384XMLPUBFUN xmlNodeSetPtr XMLCALL
385 xmlXPathDistinct (xmlNodeSetPtr nodes);
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000386
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000387XMLPUBFUN int XMLCALL
388 xmlXPathHasSameNodes (xmlNodeSetPtr nodes1,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000389 xmlNodeSetPtr nodes2);
390
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000391XMLPUBFUN xmlNodeSetPtr XMLCALL
392 xmlXPathNodeLeadingSorted (xmlNodeSetPtr nodes,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000393 xmlNodePtr node);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000394XMLPUBFUN xmlNodeSetPtr XMLCALL
395 xmlXPathLeadingSorted (xmlNodeSetPtr nodes1,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000396 xmlNodeSetPtr nodes2);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000397XMLPUBFUN xmlNodeSetPtr XMLCALL
398 xmlXPathNodeLeading (xmlNodeSetPtr nodes,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000399 xmlNodePtr node);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000400XMLPUBFUN xmlNodeSetPtr XMLCALL
401 xmlXPathLeading (xmlNodeSetPtr nodes1,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000402 xmlNodeSetPtr nodes2);
403
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000404XMLPUBFUN xmlNodeSetPtr XMLCALL
405 xmlXPathNodeTrailingSorted (xmlNodeSetPtr nodes,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000406 xmlNodePtr node);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000407XMLPUBFUN xmlNodeSetPtr XMLCALL
408 xmlXPathTrailingSorted (xmlNodeSetPtr nodes1,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000409 xmlNodeSetPtr nodes2);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000410XMLPUBFUN xmlNodeSetPtr XMLCALL
411 xmlXPathNodeTrailing (xmlNodeSetPtr nodes,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000412 xmlNodePtr node);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000413XMLPUBFUN xmlNodeSetPtr XMLCALL
414 xmlXPathTrailing (xmlNodeSetPtr nodes1,
Thomas Broyerf06a3d82001-07-16 04:52:57 +0000415 xmlNodeSetPtr nodes2);
416
417
Owen Taylor3473f882001-02-23 17:55:21 +0000418/**
Daniel Veillard61f26172002-03-12 18:46:39 +0000419 * Extending a context.
Owen Taylor3473f882001-02-23 17:55:21 +0000420 */
421
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000422XMLPUBFUN int XMLCALL
423 xmlXPathRegisterNs (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000424 const xmlChar *prefix,
425 const xmlChar *ns_uri);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000426XMLPUBFUN const xmlChar * XMLCALL
427 xmlXPathNsLookup (xmlXPathContextPtr ctxt,
Daniel Veillardcbaf3992001-12-31 16:16:02 +0000428 const xmlChar *prefix);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000429XMLPUBFUN void XMLCALL
430 xmlXPathRegisteredNsCleanup (xmlXPathContextPtr ctxt);
Owen Taylor3473f882001-02-23 17:55:21 +0000431
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000432XMLPUBFUN int XMLCALL
433 xmlXPathRegisterFunc (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000434 const xmlChar *name,
435 xmlXPathFunction f);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000436XMLPUBFUN int XMLCALL
437 xmlXPathRegisterFuncNS (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000438 const xmlChar *name,
439 const xmlChar *ns_uri,
440 xmlXPathFunction f);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000441XMLPUBFUN int XMLCALL
442 xmlXPathRegisterVariable (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000443 const xmlChar *name,
444 xmlXPathObjectPtr value);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000445XMLPUBFUN int XMLCALL
446 xmlXPathRegisterVariableNS (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000447 const xmlChar *name,
448 const xmlChar *ns_uri,
449 xmlXPathObjectPtr value);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000450XMLPUBFUN xmlXPathFunction XMLCALL
451 xmlXPathFunctionLookup (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000452 const xmlChar *name);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000453XMLPUBFUN xmlXPathFunction XMLCALL
454 xmlXPathFunctionLookupNS (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000455 const xmlChar *name,
456 const xmlChar *ns_uri);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000457XMLPUBFUN void XMLCALL
458 xmlXPathRegisteredFuncsCleanup (xmlXPathContextPtr ctxt);
459XMLPUBFUN xmlXPathObjectPtr XMLCALL
460 xmlXPathVariableLookup (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000461 const xmlChar *name);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000462XMLPUBFUN xmlXPathObjectPtr XMLCALL
463 xmlXPathVariableLookupNS (xmlXPathContextPtr ctxt,
Owen Taylor3473f882001-02-23 17:55:21 +0000464 const xmlChar *name,
465 const xmlChar *ns_uri);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000466XMLPUBFUN void XMLCALL
467 xmlXPathRegisteredVariablesCleanup(xmlXPathContextPtr ctxt);
Owen Taylor3473f882001-02-23 17:55:21 +0000468
469/**
Daniel Veillard61f26172002-03-12 18:46:39 +0000470 * Utilities to extend XPath.
Owen Taylor3473f882001-02-23 17:55:21 +0000471 */
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000472XMLPUBFUN xmlXPathParserContextPtr XMLCALL
Owen Taylor3473f882001-02-23 17:55:21 +0000473 xmlXPathNewParserContext (const xmlChar *str,
474 xmlXPathContextPtr ctxt);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000475XMLPUBFUN void XMLCALL
476 xmlXPathFreeParserContext (xmlXPathParserContextPtr ctxt);
Owen Taylor3473f882001-02-23 17:55:21 +0000477
Daniel Veillard61f26172002-03-12 18:46:39 +0000478/* TODO: remap to xmlXPathValuePop and Push. */
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000479XMLPUBFUN xmlXPathObjectPtr XMLCALL
480 valuePop (xmlXPathParserContextPtr ctxt);
481XMLPUBFUN int XMLCALL
482 valuePush (xmlXPathParserContextPtr ctxt,
483 xmlXPathObjectPtr value);
Owen Taylor3473f882001-02-23 17:55:21 +0000484
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000485XMLPUBFUN xmlXPathObjectPtr XMLCALL
486 xmlXPathNewString (const xmlChar *val);
487XMLPUBFUN xmlXPathObjectPtr XMLCALL
488 xmlXPathNewCString (const char *val);
489XMLPUBFUN xmlXPathObjectPtr XMLCALL
490 xmlXPathWrapString (xmlChar *val);
491XMLPUBFUN xmlXPathObjectPtr XMLCALL
492 xmlXPathWrapCString (char * val);
493XMLPUBFUN xmlXPathObjectPtr XMLCALL
494 xmlXPathNewFloat (double val);
495XMLPUBFUN xmlXPathObjectPtr XMLCALL
496 xmlXPathNewBoolean (int val);
497XMLPUBFUN xmlXPathObjectPtr XMLCALL
498 xmlXPathNewNodeSet (xmlNodePtr val);
499XMLPUBFUN xmlXPathObjectPtr XMLCALL
500 xmlXPathNewValueTree (xmlNodePtr val);
501XMLPUBFUN void XMLCALL
502 xmlXPathNodeSetAdd (xmlNodeSetPtr cur,
Owen Taylor3473f882001-02-23 17:55:21 +0000503 xmlNodePtr val);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000504XMLPUBFUN void XMLCALL
505 xmlXPathNodeSetAddUnique (xmlNodeSetPtr cur,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000506 xmlNodePtr val);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000507XMLPUBFUN void XMLCALL
508 xmlXPathNodeSetAddNs (xmlNodeSetPtr cur,
Aleksey Sanin79376ba2002-05-14 06:41:32 +0000509 xmlNodePtr node,
510 xmlNsPtr ns);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000511XMLPUBFUN void XMLCALL
512 xmlXPathNodeSetSort (xmlNodeSetPtr set);
Owen Taylor3473f882001-02-23 17:55:21 +0000513
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000514XMLPUBFUN void XMLCALL
515 xmlXPathRoot (xmlXPathParserContextPtr ctxt);
516XMLPUBFUN void XMLCALL
517 xmlXPathEvalExpr (xmlXPathParserContextPtr ctxt);
518XMLPUBFUN xmlChar * XMLCALL
519 xmlXPathParseName (xmlXPathParserContextPtr ctxt);
520XMLPUBFUN xmlChar * XMLCALL
521 xmlXPathParseNCName (xmlXPathParserContextPtr ctxt);
Owen Taylor3473f882001-02-23 17:55:21 +0000522
523/*
Daniel Veillard61f26172002-03-12 18:46:39 +0000524 * Existing functions.
Owen Taylor3473f882001-02-23 17:55:21 +0000525 */
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +0000526XMLPUBFUN double XMLCALL
527 xmlXPathStringEvalNumber (const xmlChar *str);
528XMLPUBFUN int XMLCALL
529 xmlXPathEvaluatePredicateResult (xmlXPathParserContextPtr ctxt,
530 xmlXPathObjectPtr res);
531XMLPUBFUN void XMLCALL
532 xmlXPathRegisterAllFunctions (xmlXPathContextPtr ctxt);
533XMLPUBFUN xmlNodeSetPtr XMLCALL
534 xmlXPathNodeSetMerge (xmlNodeSetPtr val1,
535 xmlNodeSetPtr val2);
536XMLPUBFUN void XMLCALL
537 xmlXPathNodeSetDel (xmlNodeSetPtr cur,
538 xmlNodePtr val);
539XMLPUBFUN void XMLCALL
540 xmlXPathNodeSetRemove (xmlNodeSetPtr cur,
541 int val);
542XMLPUBFUN xmlXPathObjectPtr XMLCALL
543 xmlXPathNewNodeSetList (xmlNodeSetPtr val);
544XMLPUBFUN xmlXPathObjectPtr XMLCALL
545 xmlXPathWrapNodeSet (xmlNodeSetPtr val);
546XMLPUBFUN xmlXPathObjectPtr XMLCALL
547 xmlXPathWrapExternal (void *val);
Owen Taylor3473f882001-02-23 17:55:21 +0000548
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000549XMLPUBFUN int XMLCALL xmlXPathEqualValues(xmlXPathParserContextPtr ctxt);
550XMLPUBFUN int XMLCALL xmlXPathNotEqualValues(xmlXPathParserContextPtr ctxt);
551XMLPUBFUN int XMLCALL xmlXPathCompareValues(xmlXPathParserContextPtr ctxt, int inf, int strict);
552XMLPUBFUN void XMLCALL xmlXPathValueFlipSign(xmlXPathParserContextPtr ctxt);
553XMLPUBFUN void XMLCALL xmlXPathAddValues(xmlXPathParserContextPtr ctxt);
554XMLPUBFUN void XMLCALL xmlXPathSubValues(xmlXPathParserContextPtr ctxt);
555XMLPUBFUN void XMLCALL xmlXPathMultValues(xmlXPathParserContextPtr ctxt);
556XMLPUBFUN void XMLCALL xmlXPathDivValues(xmlXPathParserContextPtr ctxt);
557XMLPUBFUN void XMLCALL xmlXPathModValues(xmlXPathParserContextPtr ctxt);
Owen Taylor3473f882001-02-23 17:55:21 +0000558
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000559XMLPUBFUN int XMLCALL xmlXPathIsNodeType(const xmlChar *name);
Owen Taylor3473f882001-02-23 17:55:21 +0000560
561/*
Daniel Veillard61f26172002-03-12 18:46:39 +0000562 * Some of the axis navigation routines.
Owen Taylor3473f882001-02-23 17:55:21 +0000563 */
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000564XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextSelf(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000565 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000566XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextChild(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000567 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000568XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextDescendant(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000569 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000570XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextDescendantOrSelf(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000571 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000572XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextParent(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000573 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000574XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextAncestorOrSelf(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000575 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000576XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextFollowingSibling(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000577 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000578XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextFollowing(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000579 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000580XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextNamespace(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000581 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000582XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextAttribute(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000583 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000584XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextPreceding(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000585 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000586XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextAncestor(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000587 xmlNodePtr cur);
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000588XMLPUBFUN xmlNodePtr XMLCALL xmlXPathNextPrecedingSibling(xmlXPathParserContextPtr ctxt,
Daniel Veillard56a4cb82001-03-24 17:00:36 +0000589 xmlNodePtr cur);
Owen Taylor3473f882001-02-23 17:55:21 +0000590/*
Daniel Veillard61f26172002-03-12 18:46:39 +0000591 * The official core of XPath functions.
Owen Taylor3473f882001-02-23 17:55:21 +0000592 */
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000593XMLPUBFUN void XMLCALL xmlXPathLastFunction(xmlXPathParserContextPtr ctxt, int nargs);
594XMLPUBFUN void XMLCALL xmlXPathPositionFunction(xmlXPathParserContextPtr ctxt, int nargs);
595XMLPUBFUN void XMLCALL xmlXPathCountFunction(xmlXPathParserContextPtr ctxt, int nargs);
596XMLPUBFUN void XMLCALL xmlXPathIdFunction(xmlXPathParserContextPtr ctxt, int nargs);
597XMLPUBFUN void XMLCALL xmlXPathLocalNameFunction(xmlXPathParserContextPtr ctxt, int nargs);
598XMLPUBFUN void XMLCALL xmlXPathNamespaceURIFunction(xmlXPathParserContextPtr ctxt, int nargs);
599XMLPUBFUN void XMLCALL xmlXPathStringFunction(xmlXPathParserContextPtr ctxt, int nargs);
600XMLPUBFUN void XMLCALL xmlXPathStringLengthFunction(xmlXPathParserContextPtr ctxt, int nargs);
601XMLPUBFUN void XMLCALL xmlXPathConcatFunction(xmlXPathParserContextPtr ctxt, int nargs);
602XMLPUBFUN void XMLCALL xmlXPathContainsFunction(xmlXPathParserContextPtr ctxt, int nargs);
603XMLPUBFUN void XMLCALL xmlXPathStartsWithFunction(xmlXPathParserContextPtr ctxt, int nargs);
604XMLPUBFUN void XMLCALL xmlXPathSubstringFunction(xmlXPathParserContextPtr ctxt, int nargs);
605XMLPUBFUN void XMLCALL xmlXPathSubstringBeforeFunction(xmlXPathParserContextPtr ctxt, int nargs);
606XMLPUBFUN void XMLCALL xmlXPathSubstringAfterFunction(xmlXPathParserContextPtr ctxt, int nargs);
607XMLPUBFUN void XMLCALL xmlXPathNormalizeFunction(xmlXPathParserContextPtr ctxt, int nargs);
608XMLPUBFUN void XMLCALL xmlXPathTranslateFunction(xmlXPathParserContextPtr ctxt, int nargs);
609XMLPUBFUN void XMLCALL xmlXPathNotFunction(xmlXPathParserContextPtr ctxt, int nargs);
610XMLPUBFUN void XMLCALL xmlXPathTrueFunction(xmlXPathParserContextPtr ctxt, int nargs);
611XMLPUBFUN void XMLCALL xmlXPathFalseFunction(xmlXPathParserContextPtr ctxt, int nargs);
612XMLPUBFUN void XMLCALL xmlXPathLangFunction(xmlXPathParserContextPtr ctxt, int nargs);
613XMLPUBFUN void XMLCALL xmlXPathNumberFunction(xmlXPathParserContextPtr ctxt, int nargs);
614XMLPUBFUN void XMLCALL xmlXPathSumFunction(xmlXPathParserContextPtr ctxt, int nargs);
615XMLPUBFUN void XMLCALL xmlXPathFloorFunction(xmlXPathParserContextPtr ctxt, int nargs);
616XMLPUBFUN void XMLCALL xmlXPathCeilingFunction(xmlXPathParserContextPtr ctxt, int nargs);
617XMLPUBFUN void XMLCALL xmlXPathRoundFunction(xmlXPathParserContextPtr ctxt, int nargs);
618XMLPUBFUN void XMLCALL xmlXPathBooleanFunction(xmlXPathParserContextPtr ctxt, int nargs);
Aleksey Saninf8cb6dd2002-06-04 04:27:06 +0000619
620/**
621 * Really internal functions
622 */
Igor Zlatkovic76874e42003-08-25 09:05:12 +0000623XMLPUBFUN void XMLCALL xmlXPathNodeSetFreeNs(xmlNsPtr ns);
Aleksey Saninf8cb6dd2002-06-04 04:27:06 +0000624
Owen Taylor3473f882001-02-23 17:55:21 +0000625#ifdef __cplusplus
626}
627#endif
Daniel Veillarda2351322004-06-27 12:08:10 +0000628
629#endif /* LIBXML_XPATH_ENABLED */
Owen Taylor3473f882001-02-23 17:55:21 +0000630#endif /* ! __XML_XPATH_INTERNALS_H__ */