blob: 3a38437cac7c6316219188dd449eb387d7ff95b4 [file] [log] [blame]
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001<HTML
2><HEAD
3><TITLE
4>xpointer</TITLE
5><META
6NAME="GENERATOR"
Daniel Veillard503b8932001-01-05 06:36:31 +00007CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
Daniel Veillardb732a0e2000-10-15 11:27:01 +00008REL="HOME"
9TITLE="Gnome XML Library Reference Manual"
10HREF="book1.html"><LINK
11REL="UP"
12TITLE="Libxml Library Reference"
13HREF="libxml-lib.html"><LINK
14REL="PREVIOUS"
Daniel Veillard29a11cc2000-10-25 13:32:39 +000015TITLE="xpathInternals"
Daniel Veillard9cb5ff42001-01-29 08:22:21 +000016HREF="libxml-xpathinternals.html"><LINK
Daniel Veillardb732a0e2000-10-15 11:27:01 +000017REL="NEXT"
Daniel Veillard28929b22000-11-13 18:22:49 +000018TITLE="xinclude"
Daniel Veillard9cb5ff42001-01-29 08:22:21 +000019HREF="libxml-xinclude.html"></HEAD
Daniel Veillardb732a0e2000-10-15 11:27:01 +000020><BODY
21BGCOLOR="#FFFFFF"
22TEXT="#000000"
Daniel Veillard503b8932001-01-05 06:36:31 +000023LINK="#0000FF"
24VLINK="#840084"
25ALINK="#0000FF"
Daniel Veillardb732a0e2000-10-15 11:27:01 +000026><DIV
27CLASS="NAVHEADER"
28><TABLE
29WIDTH="100%"
30BORDER="0"
31BGCOLOR="#000000"
32CELLPADDING="1"
33CELLSPACING="0"
34><TR
35><TH
36COLSPAN="4"
37ALIGN="center"
38><FONT
39COLOR="#FFFFFF"
40SIZE="5"
41>Gnome XML Library Reference Manual</FONT
42></TH
43></TR
44><TR
45><TD
46WIDTH="25%"
47BGCOLOR="#C00000"
48ALIGN="left"
49><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +000050HREF="libxml-xpathinternals.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +000051><FONT
52COLOR="#FFFFFF"
53SIZE="3"
54><B
55>&#60;&#60;&#60; Previous Page</B
56></FONT
57></A
58></TD
59><TD
60WIDTH="25%"
61BGCOLOR="#0000C0"
62ALIGN="center"
63><FONT
64COLOR="#FFFFFF"
65SIZE="3"
66><B
67><A
68HREF="book1.html"
69><FONT
70COLOR="#FFFFFF"
71SIZE="3"
72><B
73>Home</B
74></FONT
75></A
76></B
77></FONT
78></TD
79><TD
80WIDTH="25%"
81BGCOLOR="#00C000"
82ALIGN="center"
83><FONT
84COLOR="#FFFFFF"
85SIZE="3"
86><B
87><A
88HREF="libxml-lib.html"
89><FONT
90COLOR="#FFFFFF"
91SIZE="3"
92><B
93>Up</B
94></FONT
95></A
96></B
97></FONT
98></TD
99><TD
100WIDTH="25%"
101BGCOLOR="#C00000"
102ALIGN="right"
103><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000104HREF="libxml-xinclude.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000105><FONT
106COLOR="#FFFFFF"
107SIZE="3"
108><B
109>Next Page &#62;&#62;&#62;</B
110></FONT
111></A
112></TD
113></TR
114></TABLE
115></DIV
116><H1
Daniel Veillard503b8932001-01-05 06:36:31 +0000117><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000118NAME="LIBXML-XPOINTER"
Daniel Veillard503b8932001-01-05 06:36:31 +0000119>xpointer</A
120></H1
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000121><DIV
122CLASS="REFNAMEDIV"
123><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000124NAME="AEN13475"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000125></A
126><H2
127>Name</H2
Daniel Veillard503b8932001-01-05 06:36:31 +0000128>xpointer&nbsp;--&nbsp;</DIV
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000129><DIV
130CLASS="REFSYNOPSISDIV"
131><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000132NAME="AEN13478"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000133></A
134><H2
135>Synopsis</H2
136><TABLE
137BORDER="0"
138BGCOLOR="#D6E8FF"
139WIDTH="100%"
140CELLPADDING="6"
141><TR
142><TD
143><PRE
144CLASS="SYNOPSIS"
145>&#13;
146
147struct <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000148HREF="libxml-xpointer.html#XMLLOCATIONSET"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000149>xmlLocationSet</A
150>;
151typedef <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000152HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000153>xmlLocationSetPtr</A
154>;
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000155<A
156HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
157>xmlLocationSetPtr</A
158> <A
159HREF="libxml-xpointer.html#XMLXPTRLOCATIONSETCREATE"
160>xmlXPtrLocationSetCreate</A
161> (<A
162HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
163>xmlXPathObjectPtr</A
164> val);
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000165void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000166HREF="libxml-xpointer.html#XMLXPTRFREELOCATIONSET"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000167>xmlXPtrFreeLocationSet</A
168> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000169HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000170>xmlLocationSetPtr</A
171> obj);
172<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000173HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000174>xmlLocationSetPtr</A
175> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000176HREF="libxml-xpointer.html#XMLXPTRLOCATIONSETMERGE"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000177>xmlXPtrLocationSetMerge</A
178> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000179HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000180>xmlLocationSetPtr</A
181> val1,
182 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000183HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000184>xmlLocationSetPtr</A
185> val2);
186<A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000187HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
188>xmlXPathObjectPtr</A
189> <A
190HREF="libxml-xpointer.html#XMLXPTRNEWRANGENODEOBJECT"
191>xmlXPtrNewRangeNodeObject</A
192> (<A
193HREF="libxml-tree.html#XMLNODEPTR"
194>xmlNodePtr</A
195> start,
196 <A
197HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
198>xmlXPathObjectPtr</A
199> end);
200void <A
201HREF="libxml-xpointer.html#XMLXPTRLOCATIONSETADD"
202>xmlXPtrLocationSetAdd</A
203> (<A
204HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
205>xmlLocationSetPtr</A
206> cur,
207 <A
208HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
209>xmlXPathObjectPtr</A
210> val);
211<A
212HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
213>xmlXPathObjectPtr</A
214> <A
215HREF="libxml-xpointer.html#XMLXPTRWRAPLOCATIONSET"
216>xmlXPtrWrapLocationSet</A
217> (<A
218HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
219>xmlLocationSetPtr</A
220> val);
221<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000222HREF="libxml-xpath.html#XMLXPATHCONTEXTPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000223>xmlXPathContextPtr</A
224> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000225HREF="libxml-xpointer.html#XMLXPTRNEWCONTEXT"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000226>xmlXPtrNewContext</A
227> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000228HREF="libxml-tree.html#XMLDOCPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000229>xmlDocPtr</A
230> doc,
231 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000232HREF="libxml-tree.html#XMLNODEPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000233>xmlNodePtr</A
234> here,
235 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000236HREF="libxml-tree.html#XMLNODEPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000237>xmlNodePtr</A
238> origin);
239<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000240HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000241>xmlXPathObjectPtr</A
242> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000243HREF="libxml-xpointer.html#XMLXPTREVAL"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000244>xmlXPtrEval</A
245> (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000246HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000247>xmlChar</A
248> *str,
249 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000250HREF="libxml-xpath.html#XMLXPATHCONTEXTPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000251>xmlXPathContextPtr</A
252> ctx);
253void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000254HREF="libxml-xpointer.html#XMLXPTRRANGETOFUNCTION"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000255>xmlXPtrRangeToFunction</A
256> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000257HREF="libxml-xpath.html#XMLXPATHPARSERCONTEXTPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000258>xmlXPathParserContextPtr</A
259> ctxt,
Daniel Veillard28929b22000-11-13 18:22:49 +0000260 int nargs);
261<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000262HREF="libxml-tree.html#XMLNODEPTR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000263>xmlNodePtr</A
264> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000265HREF="libxml-xpointer.html#XMLXPTRBUILDNODELIST"
Daniel Veillard28929b22000-11-13 18:22:49 +0000266>xmlXPtrBuildNodeList</A
267> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000268HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000269>xmlXPathObjectPtr</A
Daniel Veillarda1fe9102000-11-25 10:49:25 +0000270> obj);
271void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000272HREF="libxml-xpointer.html#XMLXPTREVALRANGEPREDICATE"
Daniel Veillarda1fe9102000-11-25 10:49:25 +0000273>xmlXPtrEvalRangePredicate</A
274> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000275HREF="libxml-xpath.html#XMLXPATHPARSERCONTEXTPTR"
Daniel Veillarda1fe9102000-11-25 10:49:25 +0000276>xmlXPathParserContextPtr</A
277> ctxt);</PRE
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000278></TD
279></TR
280></TABLE
281></DIV
282><DIV
283CLASS="REFSECT1"
284><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000285NAME="AEN13518"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000286></A
287><H2
288>Description</H2
289><P
290></P
291></DIV
292><DIV
293CLASS="REFSECT1"
294><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000295NAME="AEN13521"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000296></A
297><H2
298>Details</H2
299><DIV
300CLASS="REFSECT2"
301><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000302NAME="AEN13523"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000303></A
304><H3
305><A
306NAME="XMLLOCATIONSET"
307></A
308>struct xmlLocationSet</H3
309><TABLE
310BORDER="0"
311BGCOLOR="#D6E8FF"
312WIDTH="100%"
313CELLPADDING="6"
314><TR
315><TD
316><PRE
317CLASS="PROGRAMLISTING"
318>struct xmlLocationSet {
319 int locNr; /* number of locations in the set */
320 int locMax; /* size of the array as allocated */
321 xmlXPathObjectPtr *locTab;/* array of locations */
322};</PRE
323></TD
324></TR
325></TABLE
326><P
327></P
328></DIV
329><HR><DIV
330CLASS="REFSECT2"
331><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000332NAME="AEN13528"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000333></A
334><H3
335><A
336NAME="XMLLOCATIONSETPTR"
337></A
338>xmlLocationSetPtr</H3
339><TABLE
340BORDER="0"
341BGCOLOR="#D6E8FF"
342WIDTH="100%"
343CELLPADDING="6"
344><TR
345><TD
346><PRE
347CLASS="PROGRAMLISTING"
348>typedef xmlLocationSet *xmlLocationSetPtr;</PRE
349></TD
350></TR
351></TABLE
352><P
353></P
354></DIV
355><HR><DIV
356CLASS="REFSECT2"
357><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000358NAME="AEN13533"
359></A
360><H3
361><A
362NAME="XMLXPTRLOCATIONSETCREATE"
363></A
364>xmlXPtrLocationSetCreate ()</H3
365><TABLE
366BORDER="0"
367BGCOLOR="#D6E8FF"
368WIDTH="100%"
369CELLPADDING="6"
370><TR
371><TD
372><PRE
373CLASS="PROGRAMLISTING"
374><A
375HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
376>xmlLocationSetPtr</A
377> xmlXPtrLocationSetCreate (<A
378HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
379>xmlXPathObjectPtr</A
380> val);</PRE
381></TD
382></TR
383></TABLE
384><P
385>Create a new xmlLocationSetPtr of type double and of value <TT
386CLASS="PARAMETER"
387><I
388>val</I
389></TT
390></P
391><P
392></P
393><DIV
394CLASS="INFORMALTABLE"
395><P
396></P
397><TABLE
398BORDER="0"
399WIDTH="100%"
400BGCOLOR="#FFD0D0"
401CELLSPACING="0"
402CELLPADDING="4"
403CLASS="CALSTABLE"
404><TR
405><TD
406WIDTH="20%"
407ALIGN="RIGHT"
408VALIGN="TOP"
409><TT
410CLASS="PARAMETER"
411><I
412>val</I
413></TT
414>&nbsp;:</TD
415><TD
416WIDTH="80%"
417ALIGN="LEFT"
418VALIGN="TOP"
419> an initial xmlXPathObjectPtr, or NULL</TD
420></TR
421><TR
422><TD
423WIDTH="20%"
424ALIGN="RIGHT"
425VALIGN="TOP"
426><I
427CLASS="EMPHASIS"
428>Returns</I
429> :</TD
430><TD
431WIDTH="80%"
432ALIGN="LEFT"
433VALIGN="TOP"
434>the newly created object.</TD
435></TR
436></TABLE
437><P
438></P
439></DIV
440></DIV
441><HR><DIV
442CLASS="REFSECT2"
443><A
444NAME="AEN13555"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000445></A
446><H3
447><A
448NAME="XMLXPTRFREELOCATIONSET"
449></A
450>xmlXPtrFreeLocationSet ()</H3
451><TABLE
452BORDER="0"
453BGCOLOR="#D6E8FF"
454WIDTH="100%"
455CELLPADDING="6"
456><TR
457><TD
458><PRE
459CLASS="PROGRAMLISTING"
460>void xmlXPtrFreeLocationSet (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000461HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000462>xmlLocationSetPtr</A
463> obj);</PRE
464></TD
465></TR
466></TABLE
467><P
468>Free the LocationSet compound (not the actual ranges !).</P
469><P
470></P
471><DIV
472CLASS="INFORMALTABLE"
473><P
474></P
475><TABLE
476BORDER="0"
477WIDTH="100%"
478BGCOLOR="#FFD0D0"
479CELLSPACING="0"
480CELLPADDING="4"
481CLASS="CALSTABLE"
482><TR
483><TD
484WIDTH="20%"
485ALIGN="RIGHT"
486VALIGN="TOP"
487><TT
488CLASS="PARAMETER"
489><I
490>obj</I
491></TT
492>&nbsp;:</TD
493><TD
494WIDTH="80%"
495ALIGN="LEFT"
496VALIGN="TOP"
497> the xmlLocationSetPtr to free</TD
498></TR
499></TABLE
500><P
501></P
502></DIV
503></DIV
504><HR><DIV
505CLASS="REFSECT2"
506><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000507NAME="AEN13571"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000508></A
509><H3
510><A
511NAME="XMLXPTRLOCATIONSETMERGE"
512></A
513>xmlXPtrLocationSetMerge ()</H3
514><TABLE
515BORDER="0"
516BGCOLOR="#D6E8FF"
517WIDTH="100%"
518CELLPADDING="6"
519><TR
520><TD
521><PRE
522CLASS="PROGRAMLISTING"
523><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000524HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000525>xmlLocationSetPtr</A
526> xmlXPtrLocationSetMerge (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000527HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000528>xmlLocationSetPtr</A
529> val1,
530 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000531HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000532>xmlLocationSetPtr</A
533> val2);</PRE
534></TD
535></TR
536></TABLE
537><P
538>Merges two rangesets, all ranges from <TT
539CLASS="PARAMETER"
540><I
541>val2</I
542></TT
543> are added to <TT
544CLASS="PARAMETER"
545><I
546>val1</I
547></TT
548></P
549><P
550></P
551><DIV
552CLASS="INFORMALTABLE"
553><P
554></P
555><TABLE
556BORDER="0"
557WIDTH="100%"
558BGCOLOR="#FFD0D0"
559CELLSPACING="0"
560CELLPADDING="4"
561CLASS="CALSTABLE"
562><TR
563><TD
564WIDTH="20%"
565ALIGN="RIGHT"
566VALIGN="TOP"
567><TT
568CLASS="PARAMETER"
569><I
570>val1</I
571></TT
572>&nbsp;:</TD
573><TD
574WIDTH="80%"
575ALIGN="LEFT"
576VALIGN="TOP"
577> the first LocationSet</TD
578></TR
579><TR
580><TD
581WIDTH="20%"
582ALIGN="RIGHT"
583VALIGN="TOP"
584><TT
585CLASS="PARAMETER"
586><I
587>val2</I
588></TT
589>&nbsp;:</TD
590><TD
591WIDTH="80%"
592ALIGN="LEFT"
593VALIGN="TOP"
594> the second LocationSet</TD
595></TR
596><TR
597><TD
598WIDTH="20%"
599ALIGN="RIGHT"
600VALIGN="TOP"
601><I
602CLASS="EMPHASIS"
603>Returns</I
604> :</TD
605><TD
606WIDTH="80%"
607ALIGN="LEFT"
608VALIGN="TOP"
609>val1 once extended or NULL in case of error.</TD
610></TR
611></TABLE
612><P
613></P
614></DIV
615></DIV
616><HR><DIV
617CLASS="REFSECT2"
618><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +0000619NAME="AEN13599"
620></A
621><H3
622><A
623NAME="XMLXPTRNEWRANGENODEOBJECT"
624></A
625>xmlXPtrNewRangeNodeObject ()</H3
626><TABLE
627BORDER="0"
628BGCOLOR="#D6E8FF"
629WIDTH="100%"
630CELLPADDING="6"
631><TR
632><TD
633><PRE
634CLASS="PROGRAMLISTING"
635><A
636HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
637>xmlXPathObjectPtr</A
638> xmlXPtrNewRangeNodeObject (<A
639HREF="libxml-tree.html#XMLNODEPTR"
640>xmlNodePtr</A
641> start,
642 <A
643HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
644>xmlXPathObjectPtr</A
645> end);</PRE
646></TD
647></TR
648></TABLE
649><P
650>Create a new xmlXPathObjectPtr of type range from a not to an object</P
651><P
652></P
653><DIV
654CLASS="INFORMALTABLE"
655><P
656></P
657><TABLE
658BORDER="0"
659WIDTH="100%"
660BGCOLOR="#FFD0D0"
661CELLSPACING="0"
662CELLPADDING="4"
663CLASS="CALSTABLE"
664><TR
665><TD
666WIDTH="20%"
667ALIGN="RIGHT"
668VALIGN="TOP"
669><TT
670CLASS="PARAMETER"
671><I
672>start</I
673></TT
674>&nbsp;:</TD
675><TD
676WIDTH="80%"
677ALIGN="LEFT"
678VALIGN="TOP"
679> the starting node</TD
680></TR
681><TR
682><TD
683WIDTH="20%"
684ALIGN="RIGHT"
685VALIGN="TOP"
686><TT
687CLASS="PARAMETER"
688><I
689>end</I
690></TT
691>&nbsp;:</TD
692><TD
693WIDTH="80%"
694ALIGN="LEFT"
695VALIGN="TOP"
696> the ending object</TD
697></TR
698><TR
699><TD
700WIDTH="20%"
701ALIGN="RIGHT"
702VALIGN="TOP"
703><I
704CLASS="EMPHASIS"
705>Returns</I
706> :</TD
707><TD
708WIDTH="80%"
709ALIGN="LEFT"
710VALIGN="TOP"
711>the newly created object.</TD
712></TR
713></TABLE
714><P
715></P
716></DIV
717></DIV
718><HR><DIV
719CLASS="REFSECT2"
720><A
721NAME="AEN13625"
722></A
723><H3
724><A
725NAME="XMLXPTRLOCATIONSETADD"
726></A
727>xmlXPtrLocationSetAdd ()</H3
728><TABLE
729BORDER="0"
730BGCOLOR="#D6E8FF"
731WIDTH="100%"
732CELLPADDING="6"
733><TR
734><TD
735><PRE
736CLASS="PROGRAMLISTING"
737>void xmlXPtrLocationSetAdd (<A
738HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
739>xmlLocationSetPtr</A
740> cur,
741 <A
742HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
743>xmlXPathObjectPtr</A
744> val);</PRE
745></TD
746></TR
747></TABLE
748><P
749>add a new xmlXPathObjectPtr ot an existing LocationSet
750If the location already exist in the set <TT
751CLASS="PARAMETER"
752><I
753>val</I
754></TT
755> is freed.</P
756><P
757></P
758><DIV
759CLASS="INFORMALTABLE"
760><P
761></P
762><TABLE
763BORDER="0"
764WIDTH="100%"
765BGCOLOR="#FFD0D0"
766CELLSPACING="0"
767CELLPADDING="4"
768CLASS="CALSTABLE"
769><TR
770><TD
771WIDTH="20%"
772ALIGN="RIGHT"
773VALIGN="TOP"
774><TT
775CLASS="PARAMETER"
776><I
777>cur</I
778></TT
779>&nbsp;:</TD
780><TD
781WIDTH="80%"
782ALIGN="LEFT"
783VALIGN="TOP"
784> the initial range set</TD
785></TR
786><TR
787><TD
788WIDTH="20%"
789ALIGN="RIGHT"
790VALIGN="TOP"
791><TT
792CLASS="PARAMETER"
793><I
794>val</I
795></TT
796>&nbsp;:</TD
797><TD
798WIDTH="80%"
799ALIGN="LEFT"
800VALIGN="TOP"
801> a new xmlXPathObjectPtr</TD
802></TR
803></TABLE
804><P
805></P
806></DIV
807></DIV
808><HR><DIV
809CLASS="REFSECT2"
810><A
811NAME="AEN13647"
812></A
813><H3
814><A
815NAME="XMLXPTRWRAPLOCATIONSET"
816></A
817>xmlXPtrWrapLocationSet ()</H3
818><TABLE
819BORDER="0"
820BGCOLOR="#D6E8FF"
821WIDTH="100%"
822CELLPADDING="6"
823><TR
824><TD
825><PRE
826CLASS="PROGRAMLISTING"
827><A
828HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
829>xmlXPathObjectPtr</A
830> xmlXPtrWrapLocationSet (<A
831HREF="libxml-xpointer.html#XMLLOCATIONSETPTR"
832>xmlLocationSetPtr</A
833> val);</PRE
834></TD
835></TR
836></TABLE
837><P
838>Wrap the LocationSet <TT
839CLASS="PARAMETER"
840><I
841>val</I
842></TT
843> in a new xmlXPathObjectPtr</P
844><P
845></P
846><DIV
847CLASS="INFORMALTABLE"
848><P
849></P
850><TABLE
851BORDER="0"
852WIDTH="100%"
853BGCOLOR="#FFD0D0"
854CELLSPACING="0"
855CELLPADDING="4"
856CLASS="CALSTABLE"
857><TR
858><TD
859WIDTH="20%"
860ALIGN="RIGHT"
861VALIGN="TOP"
862><TT
863CLASS="PARAMETER"
864><I
865>val</I
866></TT
867>&nbsp;:</TD
868><TD
869WIDTH="80%"
870ALIGN="LEFT"
871VALIGN="TOP"
872> the LocationSet value</TD
873></TR
874><TR
875><TD
876WIDTH="20%"
877ALIGN="RIGHT"
878VALIGN="TOP"
879><I
880CLASS="EMPHASIS"
881>Returns</I
882> :</TD
883><TD
884WIDTH="80%"
885ALIGN="LEFT"
886VALIGN="TOP"
887>the newly created object.</TD
888></TR
889></TABLE
890><P
891></P
892></DIV
893></DIV
894><HR><DIV
895CLASS="REFSECT2"
896><A
897NAME="AEN13669"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000898></A
899><H3
900><A
901NAME="XMLXPTRNEWCONTEXT"
902></A
903>xmlXPtrNewContext ()</H3
904><TABLE
905BORDER="0"
906BGCOLOR="#D6E8FF"
907WIDTH="100%"
908CELLPADDING="6"
909><TR
910><TD
911><PRE
912CLASS="PROGRAMLISTING"
913><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000914HREF="libxml-xpath.html#XMLXPATHCONTEXTPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000915>xmlXPathContextPtr</A
916> xmlXPtrNewContext (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000917HREF="libxml-tree.html#XMLDOCPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000918>xmlDocPtr</A
919> doc,
920 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000921HREF="libxml-tree.html#XMLNODEPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000922>xmlNodePtr</A
923> here,
924 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000925HREF="libxml-tree.html#XMLNODEPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000926>xmlNodePtr</A
927> origin);</PRE
928></TD
929></TR
930></TABLE
931><P
932>Create a new XPointer context</P
933><P
934></P
935><DIV
936CLASS="INFORMALTABLE"
937><P
938></P
939><TABLE
940BORDER="0"
941WIDTH="100%"
942BGCOLOR="#FFD0D0"
943CELLSPACING="0"
944CELLPADDING="4"
945CLASS="CALSTABLE"
946><TR
947><TD
948WIDTH="20%"
949ALIGN="RIGHT"
950VALIGN="TOP"
951><TT
952CLASS="PARAMETER"
953><I
954>doc</I
955></TT
956>&nbsp;:</TD
957><TD
958WIDTH="80%"
959ALIGN="LEFT"
960VALIGN="TOP"
961> the XML document</TD
962></TR
963><TR
964><TD
965WIDTH="20%"
966ALIGN="RIGHT"
967VALIGN="TOP"
968><TT
969CLASS="PARAMETER"
970><I
971>here</I
972></TT
973>&nbsp;:</TD
974><TD
975WIDTH="80%"
976ALIGN="LEFT"
977VALIGN="TOP"
978> the node that directly contains the XPointer being evaluated or NULL</TD
979></TR
980><TR
981><TD
982WIDTH="20%"
983ALIGN="RIGHT"
984VALIGN="TOP"
985><TT
986CLASS="PARAMETER"
987><I
988>origin</I
989></TT
990>&nbsp;:</TD
991><TD
992WIDTH="80%"
993ALIGN="LEFT"
994VALIGN="TOP"
995> the element from which a user or program initiated traversal of
996the link, or NULL.</TD
997></TR
998><TR
999><TD
1000WIDTH="20%"
1001ALIGN="RIGHT"
1002VALIGN="TOP"
1003><I
1004CLASS="EMPHASIS"
1005>Returns</I
1006> :</TD
1007><TD
1008WIDTH="80%"
1009ALIGN="LEFT"
1010VALIGN="TOP"
1011>the xmlXPathContext just allocated.</TD
1012></TR
1013></TABLE
1014><P
1015></P
1016></DIV
1017></DIV
1018><HR><DIV
1019CLASS="REFSECT2"
1020><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +00001021NAME="AEN13700"
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001022></A
1023><H3
1024><A
1025NAME="XMLXPTREVAL"
1026></A
1027>xmlXPtrEval ()</H3
1028><TABLE
1029BORDER="0"
1030BGCOLOR="#D6E8FF"
1031WIDTH="100%"
1032CELLPADDING="6"
1033><TR
1034><TD
1035><PRE
1036CLASS="PROGRAMLISTING"
1037><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001038HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001039>xmlXPathObjectPtr</A
1040> xmlXPtrEval (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001041HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001042>xmlChar</A
1043> *str,
1044 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001045HREF="libxml-xpath.html#XMLXPATHCONTEXTPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001046>xmlXPathContextPtr</A
1047> ctx);</PRE
1048></TD
1049></TR
1050></TABLE
1051><P
1052>Evaluate the XPath Location Path in the given context.</P
1053><P
1054></P
1055><DIV
1056CLASS="INFORMALTABLE"
1057><P
1058></P
1059><TABLE
1060BORDER="0"
1061WIDTH="100%"
1062BGCOLOR="#FFD0D0"
1063CELLSPACING="0"
1064CELLPADDING="4"
1065CLASS="CALSTABLE"
1066><TR
1067><TD
1068WIDTH="20%"
1069ALIGN="RIGHT"
1070VALIGN="TOP"
1071><TT
1072CLASS="PARAMETER"
1073><I
1074>str</I
1075></TT
1076>&nbsp;:</TD
1077><TD
1078WIDTH="80%"
1079ALIGN="LEFT"
1080VALIGN="TOP"
1081> the XPointer expression</TD
1082></TR
1083><TR
1084><TD
1085WIDTH="20%"
1086ALIGN="RIGHT"
1087VALIGN="TOP"
1088><TT
1089CLASS="PARAMETER"
1090><I
1091>ctx</I
1092></TT
1093>&nbsp;:</TD
1094><TD
1095WIDTH="80%"
1096ALIGN="LEFT"
1097VALIGN="TOP"
1098> the XPointer context</TD
1099></TR
1100><TR
1101><TD
1102WIDTH="20%"
1103ALIGN="RIGHT"
1104VALIGN="TOP"
1105><I
1106CLASS="EMPHASIS"
1107>Returns</I
1108> :</TD
1109><TD
1110WIDTH="80%"
1111ALIGN="LEFT"
1112VALIGN="TOP"
1113>the xmlXPathObjectPtr resulting from the eveluation or NULL.
1114the caller has to free the object.</TD
1115></TR
1116></TABLE
1117><P
1118></P
1119></DIV
1120></DIV
1121><HR><DIV
1122CLASS="REFSECT2"
1123><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +00001124NAME="AEN13726"
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001125></A
1126><H3
1127><A
1128NAME="XMLXPTRRANGETOFUNCTION"
1129></A
1130>xmlXPtrRangeToFunction ()</H3
1131><TABLE
1132BORDER="0"
1133BGCOLOR="#D6E8FF"
1134WIDTH="100%"
1135CELLPADDING="6"
1136><TR
1137><TD
1138><PRE
1139CLASS="PROGRAMLISTING"
1140>void xmlXPtrRangeToFunction (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001141HREF="libxml-xpath.html#XMLXPATHPARSERCONTEXTPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001142>xmlXPathParserContextPtr</A
1143> ctxt,
1144 int nargs);</PRE
1145></TD
1146></TR
1147></TABLE
1148><P
1149>Implement the range-<GTKDOCLINK
1150HREF="TO"
1151>to</GTKDOCLINK
1152>() XPointer function</P
1153><P
1154></P
1155><DIV
1156CLASS="INFORMALTABLE"
1157><P
1158></P
1159><TABLE
1160BORDER="0"
1161WIDTH="100%"
1162BGCOLOR="#FFD0D0"
1163CELLSPACING="0"
1164CELLPADDING="4"
1165CLASS="CALSTABLE"
1166><TR
1167><TD
1168WIDTH="20%"
1169ALIGN="RIGHT"
1170VALIGN="TOP"
1171><TT
1172CLASS="PARAMETER"
1173><I
1174>ctxt</I
1175></TT
1176>&nbsp;:</TD
1177><TD
1178WIDTH="80%"
1179ALIGN="LEFT"
1180VALIGN="TOP"
1181> the XPointer Parser context</TD
1182></TR
1183><TR
1184><TD
1185WIDTH="20%"
1186ALIGN="RIGHT"
1187VALIGN="TOP"
1188><TT
1189CLASS="PARAMETER"
1190><I
1191>nargs</I
1192></TT
1193>&nbsp;:</TD
1194><TD
1195WIDTH="80%"
1196ALIGN="LEFT"
1197VALIGN="TOP"
Daniel Veillard503b8932001-01-05 06:36:31 +00001198>&#13;</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001199></TR
1200></TABLE
1201><P
1202></P
1203></DIV
1204></DIV
Daniel Veillard28929b22000-11-13 18:22:49 +00001205><HR><DIV
1206CLASS="REFSECT2"
1207><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +00001208NAME="AEN13747"
Daniel Veillard28929b22000-11-13 18:22:49 +00001209></A
1210><H3
1211><A
1212NAME="XMLXPTRBUILDNODELIST"
1213></A
1214>xmlXPtrBuildNodeList ()</H3
1215><TABLE
1216BORDER="0"
1217BGCOLOR="#D6E8FF"
1218WIDTH="100%"
1219CELLPADDING="6"
1220><TR
1221><TD
1222><PRE
1223CLASS="PROGRAMLISTING"
1224><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001225HREF="libxml-tree.html#XMLNODEPTR"
Daniel Veillard28929b22000-11-13 18:22:49 +00001226>xmlNodePtr</A
1227> xmlXPtrBuildNodeList (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001228HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
Daniel Veillard28929b22000-11-13 18:22:49 +00001229>xmlXPathObjectPtr</A
1230> obj);</PRE
1231></TD
1232></TR
1233></TABLE
1234><P
1235>Build a node list tree copy of the XPointer result.</P
1236><P
1237></P
1238><DIV
1239CLASS="INFORMALTABLE"
1240><P
1241></P
1242><TABLE
1243BORDER="0"
1244WIDTH="100%"
1245BGCOLOR="#FFD0D0"
1246CELLSPACING="0"
1247CELLPADDING="4"
1248CLASS="CALSTABLE"
1249><TR
1250><TD
1251WIDTH="20%"
1252ALIGN="RIGHT"
1253VALIGN="TOP"
1254><TT
1255CLASS="PARAMETER"
1256><I
1257>obj</I
1258></TT
1259>&nbsp;:</TD
1260><TD
1261WIDTH="80%"
1262ALIGN="LEFT"
1263VALIGN="TOP"
1264> the XPointer result from the evaluation.</TD
1265></TR
1266><TR
1267><TD
1268WIDTH="20%"
1269ALIGN="RIGHT"
1270VALIGN="TOP"
1271><I
1272CLASS="EMPHASIS"
1273>Returns</I
1274> :</TD
1275><TD
1276WIDTH="80%"
1277ALIGN="LEFT"
1278VALIGN="TOP"
1279>an xmlNodePtr list or NULL.
1280the caller has to free the node tree.</TD
1281></TR
1282></TABLE
1283><P
1284></P
1285></DIV
1286></DIV
Daniel Veillarda1fe9102000-11-25 10:49:25 +00001287><HR><DIV
1288CLASS="REFSECT2"
1289><A
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +00001290NAME="AEN13768"
Daniel Veillarda1fe9102000-11-25 10:49:25 +00001291></A
1292><H3
1293><A
1294NAME="XMLXPTREVALRANGEPREDICATE"
1295></A
1296>xmlXPtrEvalRangePredicate ()</H3
1297><TABLE
1298BORDER="0"
1299BGCOLOR="#D6E8FF"
1300WIDTH="100%"
1301CELLPADDING="6"
1302><TR
1303><TD
1304><PRE
1305CLASS="PROGRAMLISTING"
1306>void xmlXPtrEvalRangePredicate (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001307HREF="libxml-xpath.html#XMLXPATHPARSERCONTEXTPTR"
Daniel Veillarda1fe9102000-11-25 10:49:25 +00001308>xmlXPathParserContextPtr</A
1309> ctxt);</PRE
1310></TD
1311></TR
1312></TABLE
1313><P
1314>[8] Predicate ::= '[' PredicateExpr ']'
1315[9] PredicateExpr ::= Expr </P
1316><P
Daniel Veillardc7ad7ce2001-03-22 21:45:29 +00001317>Evaluate a predicate as in <A
1318HREF="libxml-xpath.html#XMLXPATHEVALPREDICATE"
1319>xmlXPathEvalPredicate</A
Daniel Veillarda1fe9102000-11-25 10:49:25 +00001320>() but for
1321a Location Set instead of a node set</P
1322><P
1323></P
1324><DIV
1325CLASS="INFORMALTABLE"
1326><P
1327></P
1328><TABLE
1329BORDER="0"
1330WIDTH="100%"
1331BGCOLOR="#FFD0D0"
1332CELLSPACING="0"
1333CELLPADDING="4"
1334CLASS="CALSTABLE"
1335><TR
1336><TD
1337WIDTH="20%"
1338ALIGN="RIGHT"
1339VALIGN="TOP"
1340><TT
1341CLASS="PARAMETER"
1342><I
1343>ctxt</I
1344></TT
1345>&nbsp;:</TD
1346><TD
1347WIDTH="80%"
1348ALIGN="LEFT"
1349VALIGN="TOP"
1350> the XPointer Parser context</TD
1351></TR
1352></TABLE
1353><P
1354></P
1355></DIV
1356></DIV
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001357></DIV
1358><DIV
1359CLASS="NAVFOOTER"
1360><BR
1361CLEAR="all"><BR><TABLE
1362WIDTH="100%"
1363BORDER="0"
1364BGCOLOR="#000000"
1365CELLPADDING="1"
1366CELLSPACING="0"
1367><TR
1368><TD
1369WIDTH="25%"
1370BGCOLOR="#C00000"
1371ALIGN="left"
1372><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001373HREF="libxml-xpathinternals.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001374><FONT
1375COLOR="#FFFFFF"
1376SIZE="3"
1377><B
1378>&#60;&#60;&#60; Previous Page</B
1379></FONT
1380></A
1381></TD
1382><TD
1383WIDTH="25%"
1384BGCOLOR="#0000C0"
1385ALIGN="center"
1386><FONT
1387COLOR="#FFFFFF"
1388SIZE="3"
1389><B
1390><A
1391HREF="book1.html"
1392><FONT
1393COLOR="#FFFFFF"
1394SIZE="3"
1395><B
1396>Home</B
1397></FONT
1398></A
1399></B
1400></FONT
1401></TD
1402><TD
1403WIDTH="25%"
1404BGCOLOR="#00C000"
1405ALIGN="center"
1406><FONT
1407COLOR="#FFFFFF"
1408SIZE="3"
1409><B
1410><A
1411HREF="libxml-lib.html"
1412><FONT
1413COLOR="#FFFFFF"
1414SIZE="3"
1415><B
1416>Up</B
1417></FONT
1418></A
1419></B
1420></FONT
1421></TD
1422><TD
1423WIDTH="25%"
1424BGCOLOR="#C00000"
1425ALIGN="right"
1426><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +00001427HREF="libxml-xinclude.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001428><FONT
1429COLOR="#FFFFFF"
1430SIZE="3"
1431><B
1432>Next Page &#62;&#62;&#62;</B
1433></FONT
1434></A
1435></TD
1436></TR
1437><TR
1438><TD
1439COLSPAN="2"
1440ALIGN="left"
1441><FONT
1442COLOR="#FFFFFF"
1443SIZE="3"
1444><B
Daniel Veillard29a11cc2000-10-25 13:32:39 +00001445>xpathInternals</B
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001446></FONT
1447></TD
1448><TD
1449COLSPAN="2"
1450ALIGN="right"
1451><FONT
1452COLOR="#FFFFFF"
1453SIZE="3"
1454><B
Daniel Veillard28929b22000-11-13 18:22:49 +00001455>xinclude</B
Daniel Veillardb732a0e2000-10-15 11:27:01 +00001456></FONT
1457></TD
1458></TR
1459></TABLE
1460></DIV
1461></BODY
1462></HTML
1463>