Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / libxml2 / ef90ba7e3b530a8eb9ed27f57f0ced139b839780 / . / doc / html / libxml-uri.html
blob: c16fda0d4c601fb5e1069d2cef892fff7cac0d2f [file] [log] [blame]
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1<HTML
2><HEAD
3><TITLE
4>uri</TITLE
5><META
6NAME="GENERATOR"
Daniel Veillard60087f32001-10-10 09:45:09 +0000[diff] [blame]7CONTENT="Modular DocBook HTML Stylesheet Version 1.64
8"><LINK
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]9REL="HOME"
10TITLE="Gnome XML Library Reference Manual"
11HREF="book1.html"><LINK
12REL="UP"
13TITLE="Libxml Library Reference"
14HREF="libxml-lib.html"><LINK
15REL="PREVIOUS"
16TITLE="valid"
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]17HREF="libxml-valid.html"><LINK
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]18REL="NEXT"
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]19TITLE="xmlerror"
20HREF="libxml-xmlerror.html"></HEAD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]21><BODY
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]22CLASS="REFENTRY"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]23BGCOLOR="#FFFFFF"
24TEXT="#000000"
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]25LINK="#0000FF"
26VLINK="#840084"
27ALINK="#0000FF"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]28><DIV
29CLASS="NAVHEADER"
30><TABLE
31WIDTH="100%"
32BORDER="0"
33BGCOLOR="#000000"
34CELLPADDING="1"
35CELLSPACING="0"
36><TR
37><TH
38COLSPAN="4"
39ALIGN="center"
40><FONT
41COLOR="#FFFFFF"
42SIZE="5"
43>Gnome XML Library Reference Manual</FONT
44></TH
45></TR
46><TR
47><TD
48WIDTH="25%"
49BGCOLOR="#C00000"
50ALIGN="left"
51><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]52HREF="libxml-valid.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]53><FONT
54COLOR="#FFFFFF"
55SIZE="3"
56><B
57>&#60;&#60;&#60; Previous Page</B
58></FONT
59></A
60></TD
61><TD
62WIDTH="25%"
63BGCOLOR="#0000C0"
64ALIGN="center"
65><FONT
66COLOR="#FFFFFF"
67SIZE="3"
68><B
69><A
70HREF="book1.html"
71><FONT
72COLOR="#FFFFFF"
73SIZE="3"
74><B
75>Home</B
76></FONT
77></A
78></B
79></FONT
80></TD
81><TD
82WIDTH="25%"
83BGCOLOR="#00C000"
84ALIGN="center"
85><FONT
86COLOR="#FFFFFF"
87SIZE="3"
88><B
89><A
90HREF="libxml-lib.html"
91><FONT
92COLOR="#FFFFFF"
93SIZE="3"
94><B
95>Up</B
96></FONT
97></A
98></B
99></FONT
100></TD
101><TD
102WIDTH="25%"
103BGCOLOR="#C00000"
104ALIGN="right"
105><A
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]106HREF="libxml-xmlerror.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]107><FONT
108COLOR="#FFFFFF"
109SIZE="3"
110><B
111>Next Page &#62;&#62;&#62;</B
112></FONT
113></A
114></TD
115></TR
116></TABLE
117></DIV
118><H1
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]119><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]120NAME="LIBXML-URI"
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]121>uri</A
122></H1
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]123><DIV
124CLASS="REFNAMEDIV"
125><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]126NAME="AEN10154"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]127></A
128><H2
129>Name</H2
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]130>uri&nbsp;--&nbsp;</DIV
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]131><DIV
132CLASS="REFSYNOPSISDIV"
133><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]134NAME="AEN10157"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]135></A
136><H2
137>Synopsis</H2
138><TABLE
139BORDER="0"
140BGCOLOR="#D6E8FF"
141WIDTH="100%"
142CELLPADDING="6"
143><TR
144><TD
145><PRE
146CLASS="SYNOPSIS"
147>&#13;
148
149struct <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]150HREF="libxml-uri.html#XMLURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]151>xmlURI</A
152>;
153typedef <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]154HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]155>xmlURIPtr</A
156>;
157<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]158HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]159>xmlURIPtr</A
160> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]161HREF="libxml-uri.html#XMLCREATEURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]162>xmlCreateURI</A
163> (void);
164<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]165HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]166>xmlChar</A
167>* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]168HREF="libxml-uri.html#XMLBUILDURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]169>xmlBuildURI</A
170> (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]171HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]172>xmlChar</A
173> *URI,
174 const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]175HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]176>xmlChar</A
177> *base);
178<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]179HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]180>xmlURIPtr</A
181> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]182HREF="libxml-uri.html#XMLPARSEURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]183>xmlParseURI</A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]184> (const char *str);
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]185int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]186HREF="libxml-uri.html#XMLPARSEURIREFERENCE"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]187>xmlParseURIReference</A
188> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]189HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]190>xmlURIPtr</A
191> uri,
192 const char *str);
193<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]194HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]195>xmlChar</A
196>* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]197HREF="libxml-uri.html#XMLSAVEURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]198>xmlSaveUri</A
199> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]200HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]201>xmlURIPtr</A
202> uri);
203void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]204HREF="libxml-uri.html#XMLPRINTURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]205>xmlPrintURI</A
206> (<GTKDOCLINK
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]207HREF="FILE-CAPS"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]208>FILE</GTKDOCLINK
209> *stream,
210 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]211HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]212>xmlURIPtr</A
213> uri);
Daniel Veillard4ec885a2001-06-17 10:31:07 +0000[diff] [blame]214<A
215HREF="libxml-tree.html#XMLCHAR"
216>xmlChar</A
217>* <A
218HREF="libxml-uri.html#XMLURIESCAPESTR"
219>xmlURIEscapeStr</A
220> (const <A
221HREF="libxml-tree.html#XMLCHAR"
222>xmlChar</A
223> *str,
224 const <A
225HREF="libxml-tree.html#XMLCHAR"
226>xmlChar</A
227> *list);
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]228char* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]229HREF="libxml-uri.html#XMLURIUNESCAPESTRING"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]230>xmlURIUnescapeString</A
231> (const char *str,
232 int len,
233 char *target);
234int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]235HREF="libxml-uri.html#XMLNORMALIZEURIPATH"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]236>xmlNormalizeURIPath</A
237> (char *path);
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]238<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]239HREF="libxml-tree.html#XMLCHAR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]240>xmlChar</A
241>* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]242HREF="libxml-uri.html#XMLURIESCAPE"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]243>xmlURIEscape</A
244> (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]245HREF="libxml-tree.html#XMLCHAR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]246>xmlChar</A
247> *str);
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]248void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]249HREF="libxml-uri.html#XMLFREEURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]250>xmlFreeURI</A
251> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]252HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]253>xmlURIPtr</A
254> uri);</PRE
255></TD
256></TR
257></TABLE
258></DIV
259><DIV
260CLASS="REFSECT1"
261><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]262NAME="AEN10189"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]263></A
264><H2
265>Description</H2
266><P
267></P
268></DIV
269><DIV
270CLASS="REFSECT1"
271><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]272NAME="AEN10192"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]273></A
274><H2
275>Details</H2
276><DIV
277CLASS="REFSECT2"
278><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]279NAME="AEN10194"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]280></A
281><H3
282><A
283NAME="XMLURI"
284></A
285>struct xmlURI</H3
286><TABLE
287BORDER="0"
288BGCOLOR="#D6E8FF"
289WIDTH="100%"
290CELLPADDING="6"
291><TR
292><TD
293><PRE
294CLASS="PROGRAMLISTING"
295>struct xmlURI {
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]296 char *scheme; /* the URI scheme */
297 char *opaque; /* opaque part */
298 char *authority; /* the authority part */
299 char *server; /* the server part */
300 char *user; /* the user part */
301 int port; /* the port number */
302 char *path; /* the path string */
303 char *query; /* the query string */
304 char *fragment; /* the fragment identifier */
305 int cleanup; /* parsing potentially unclean URI */
306};</PRE
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]307></TD
308></TR
309></TABLE
310><P
Daniel Veillarde7ead2d2001-08-22 23:44:09 +0000[diff] [blame]311>A parsed URI reference. This is a struct containing the various fields
312as described in RFC 2396 but separated for further processing</P
313><P
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]314></P
315></DIV
316><HR><DIV
317CLASS="REFSECT2"
318><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]319NAME="AEN10200"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]320></A
321><H3
322><A
323NAME="XMLURIPTR"
324></A
325>xmlURIPtr</H3
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]326><TABLE
327BORDER="0"
328BGCOLOR="#D6E8FF"
329WIDTH="100%"
330CELLPADDING="6"
331><TR
332><TD
333><PRE
334CLASS="PROGRAMLISTING"
335>typedef xmlURI *xmlURIPtr;</PRE
336></TD
337></TR
338></TABLE
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]339><P
340></P
341></DIV
342><HR><DIV
343CLASS="REFSECT2"
344><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]345NAME="AEN10205"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]346></A
347><H3
348><A
349NAME="XMLCREATEURI"
350></A
351>xmlCreateURI ()</H3
352><TABLE
353BORDER="0"
354BGCOLOR="#D6E8FF"
355WIDTH="100%"
356CELLPADDING="6"
357><TR
358><TD
359><PRE
360CLASS="PROGRAMLISTING"
361><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]362HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]363>xmlURIPtr</A
364> xmlCreateURI (void);</PRE
365></TD
366></TR
367></TABLE
368><P
369>Simply creates an empty xmlURI</P
370><P
371></P
372><DIV
373CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]374><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]375NAME="AEN10212"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]376></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]377><P
378></P
379><TABLE
380BORDER="0"
381WIDTH="100%"
382BGCOLOR="#FFD0D0"
383CELLSPACING="0"
384CELLPADDING="4"
385CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]386><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]387><TR
388><TD
389WIDTH="20%"
390ALIGN="RIGHT"
391VALIGN="TOP"
392><I
393CLASS="EMPHASIS"
394>Returns</I
395> :</TD
396><TD
397WIDTH="80%"
398ALIGN="LEFT"
399VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]400>the new structure or NULL in case of error</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]401></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]402></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]403></TABLE
404><P
405></P
406></DIV
407></DIV
408><HR><DIV
409CLASS="REFSECT2"
410><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]411NAME="AEN10221"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]412></A
413><H3
414><A
415NAME="XMLBUILDURI"
416></A
417>xmlBuildURI ()</H3
418><TABLE
419BORDER="0"
420BGCOLOR="#D6E8FF"
421WIDTH="100%"
422CELLPADDING="6"
423><TR
424><TD
425><PRE
426CLASS="PROGRAMLISTING"
427><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]428HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]429>xmlChar</A
430>* xmlBuildURI (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]431HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]432>xmlChar</A
433> *URI,
434 const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]435HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]436>xmlChar</A
437> *base);</PRE
438></TD
439></TR
440></TABLE
441><P
442>Computes he final URI of the reference done by checking that
443the given URI is valid, and building the final URI using the
444base URI. This is processed according to section 5.2 of the
445RFC 2396</P
446><P
447>5.2. Resolving Relative References to Absolute Form</P
448><P
449></P
450><DIV
451CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]452><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]453NAME="AEN10231"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]454></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]455><P
456></P
457><TABLE
458BORDER="0"
459WIDTH="100%"
460BGCOLOR="#FFD0D0"
461CELLSPACING="0"
462CELLPADDING="4"
463CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]464><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]465><TR
466><TD
467WIDTH="20%"
468ALIGN="RIGHT"
469VALIGN="TOP"
470><TT
471CLASS="PARAMETER"
472><I
473>URI</I
474></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]475>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]476><TD
477WIDTH="80%"
478ALIGN="LEFT"
479VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]480> the URI instance found in the document</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]481></TR
482><TR
483><TD
484WIDTH="20%"
485ALIGN="RIGHT"
486VALIGN="TOP"
487><TT
488CLASS="PARAMETER"
489><I
490>base</I
491></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]492>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]493><TD
494WIDTH="80%"
495ALIGN="LEFT"
496VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]497> the base value</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]498></TR
499><TR
500><TD
501WIDTH="20%"
502ALIGN="RIGHT"
503VALIGN="TOP"
504><I
505CLASS="EMPHASIS"
506>Returns</I
507> :</TD
508><TD
509WIDTH="80%"
510ALIGN="LEFT"
511VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]512>a new URI string (to be freed by the caller) or NULL in case
513of error.</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]514></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]515></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]516></TABLE
517><P
518></P
519></DIV
520></DIV
521><HR><DIV
522CLASS="REFSECT2"
523><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]524NAME="AEN10248"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]525></A
526><H3
527><A
528NAME="XMLPARSEURI"
529></A
530>xmlParseURI ()</H3
531><TABLE
532BORDER="0"
533BGCOLOR="#D6E8FF"
534WIDTH="100%"
535CELLPADDING="6"
536><TR
537><TD
538><PRE
539CLASS="PROGRAMLISTING"
540><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]541HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]542>xmlURIPtr</A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]543> xmlParseURI (const char *str);</PRE
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]544></TD
545></TR
546></TABLE
547><P
548>Parse an URI </P
549><P
550>URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]</P
551><P
552></P
553><DIV
554CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]555><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]556NAME="AEN10256"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]557></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]558><P
559></P
560><TABLE
561BORDER="0"
562WIDTH="100%"
563BGCOLOR="#FFD0D0"
564CELLSPACING="0"
565CELLPADDING="4"
566CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]567><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]568><TR
569><TD
570WIDTH="20%"
571ALIGN="RIGHT"
572VALIGN="TOP"
573><TT
574CLASS="PARAMETER"
575><I
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]576>str</I
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]577></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]578>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]579><TD
580WIDTH="80%"
581ALIGN="LEFT"
582VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]583> the URI string to analyze</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]584></TR
585><TR
586><TD
587WIDTH="20%"
588ALIGN="RIGHT"
589VALIGN="TOP"
590><I
591CLASS="EMPHASIS"
592>Returns</I
593> :</TD
594><TD
595WIDTH="80%"
596ALIGN="LEFT"
597VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]598>a newly build xmlURIPtr or NULL in case of error</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]599></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]600></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]601></TABLE
602><P
603></P
604></DIV
605></DIV
606><HR><DIV
607CLASS="REFSECT2"
608><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]609NAME="AEN10269"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]610></A
611><H3
612><A
613NAME="XMLPARSEURIREFERENCE"
614></A
615>xmlParseURIReference ()</H3
616><TABLE
617BORDER="0"
618BGCOLOR="#D6E8FF"
619WIDTH="100%"
620CELLPADDING="6"
621><TR
622><TD
623><PRE
624CLASS="PROGRAMLISTING"
625>int xmlParseURIReference (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]626HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]627>xmlURIPtr</A
628> uri,
629 const char *str);</PRE
630></TD
631></TR
632></TABLE
633><P
634>Parse an URI reference string and fills in the appropriate fields
635of the <TT
636CLASS="PARAMETER"
637><I
638>uri</I
639></TT
640> structure</P
641><P
642>URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]</P
643><P
644></P
645><DIV
646CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]647><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]648NAME="AEN10278"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]649></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]650><P
651></P
652><TABLE
653BORDER="0"
654WIDTH="100%"
655BGCOLOR="#FFD0D0"
656CELLSPACING="0"
657CELLPADDING="4"
658CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]659><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]660><TR
661><TD
662WIDTH="20%"
663ALIGN="RIGHT"
664VALIGN="TOP"
665><TT
666CLASS="PARAMETER"
667><I
668>uri</I
669></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]670>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]671><TD
672WIDTH="80%"
673ALIGN="LEFT"
674VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]675> pointer to an URI structure</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]676></TR
677><TR
678><TD
679WIDTH="20%"
680ALIGN="RIGHT"
681VALIGN="TOP"
682><TT
683CLASS="PARAMETER"
684><I
685>str</I
686></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]687>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]688><TD
689WIDTH="80%"
690ALIGN="LEFT"
691VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]692> the string to analyze</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]693></TR
694><TR
695><TD
696WIDTH="20%"
697ALIGN="RIGHT"
698VALIGN="TOP"
699><I
700CLASS="EMPHASIS"
701>Returns</I
702> :</TD
703><TD
704WIDTH="80%"
705ALIGN="LEFT"
706VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]707>0 or the error code</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]708></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]709></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]710></TABLE
711><P
712></P
713></DIV
714></DIV
715><HR><DIV
716CLASS="REFSECT2"
717><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]718NAME="AEN10295"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]719></A
720><H3
721><A
722NAME="XMLSAVEURI"
723></A
724>xmlSaveUri ()</H3
725><TABLE
726BORDER="0"
727BGCOLOR="#D6E8FF"
728WIDTH="100%"
729CELLPADDING="6"
730><TR
731><TD
732><PRE
733CLASS="PROGRAMLISTING"
734><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]735HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]736>xmlChar</A
737>* xmlSaveUri (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]738HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]739>xmlURIPtr</A
740> uri);</PRE
741></TD
742></TR
743></TABLE
744><P
745>Save the URI as an escaped string</P
746><P
747></P
748><DIV
749CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]750><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]751NAME="AEN10303"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]752></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]753><P
754></P
755><TABLE
756BORDER="0"
757WIDTH="100%"
758BGCOLOR="#FFD0D0"
759CELLSPACING="0"
760CELLPADDING="4"
761CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]762><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]763><TR
764><TD
765WIDTH="20%"
766ALIGN="RIGHT"
767VALIGN="TOP"
768><TT
769CLASS="PARAMETER"
770><I
771>uri</I
772></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]773>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]774><TD
775WIDTH="80%"
776ALIGN="LEFT"
777VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]778> pointer to an xmlURI</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]779></TR
780><TR
781><TD
782WIDTH="20%"
783ALIGN="RIGHT"
784VALIGN="TOP"
785><I
786CLASS="EMPHASIS"
787>Returns</I
788> :</TD
789><TD
790WIDTH="80%"
791ALIGN="LEFT"
792VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]793>a new string (to be deallocated by caller)</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]794></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]795></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]796></TABLE
797><P
798></P
799></DIV
800></DIV
801><HR><DIV
802CLASS="REFSECT2"
803><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]804NAME="AEN10316"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]805></A
806><H3
807><A
808NAME="XMLPRINTURI"
809></A
810>xmlPrintURI ()</H3
811><TABLE
812BORDER="0"
813BGCOLOR="#D6E8FF"
814WIDTH="100%"
815CELLPADDING="6"
816><TR
817><TD
818><PRE
819CLASS="PROGRAMLISTING"
820>void xmlPrintURI (<GTKDOCLINK
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]821HREF="FILE-CAPS"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]822>FILE</GTKDOCLINK
823> *stream,
824 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]825HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]826>xmlURIPtr</A
827> uri);</PRE
828></TD
829></TR
830></TABLE
831><P
832>Prints the URI in the stream <TT
833CLASS="PARAMETER"
834><I
835>steam</I
836></TT
837>.</P
838><P
839></P
840><DIV
841CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]842><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]843NAME="AEN10325"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]844></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]845><P
846></P
847><TABLE
848BORDER="0"
849WIDTH="100%"
850BGCOLOR="#FFD0D0"
851CELLSPACING="0"
852CELLPADDING="4"
853CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]854><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]855><TR
856><TD
857WIDTH="20%"
858ALIGN="RIGHT"
859VALIGN="TOP"
860><TT
861CLASS="PARAMETER"
862><I
863>stream</I
864></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]865>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]866><TD
867WIDTH="80%"
868ALIGN="LEFT"
869VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]870> a FILE* for the output</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]871></TR
872><TR
873><TD
874WIDTH="20%"
875ALIGN="RIGHT"
876VALIGN="TOP"
877><TT
878CLASS="PARAMETER"
879><I
880>uri</I
881></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]882>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]883><TD
884WIDTH="80%"
885ALIGN="LEFT"
886VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]887> pointer to an xmlURI</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]888></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]889></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]890></TABLE
891><P
892></P
893></DIV
894></DIV
895><HR><DIV
896CLASS="REFSECT2"
897><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]898NAME="AEN10338"
Daniel Veillard4ec885a2001-06-17 10:31:07 +0000[diff] [blame]899></A
900><H3
901><A
902NAME="XMLURIESCAPESTR"
903></A
904>xmlURIEscapeStr ()</H3
905><TABLE
906BORDER="0"
907BGCOLOR="#D6E8FF"
908WIDTH="100%"
909CELLPADDING="6"
910><TR
911><TD
912><PRE
913CLASS="PROGRAMLISTING"
914><A
915HREF="libxml-tree.html#XMLCHAR"
916>xmlChar</A
917>* xmlURIEscapeStr (const <A
918HREF="libxml-tree.html#XMLCHAR"
919>xmlChar</A
920> *str,
921 const <A
922HREF="libxml-tree.html#XMLCHAR"
923>xmlChar</A
924> *list);</PRE
925></TD
926></TR
927></TABLE
928><P
929>This routine escapes a string to hex, ignoring reserved characters (a-z)
930and the characters in the exception list.</P
931><P
932></P
933><DIV
934CLASS="INFORMALTABLE"
935><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]936NAME="AEN10347"
Daniel Veillard4ec885a2001-06-17 10:31:07 +0000[diff] [blame]937></A
938><P
939></P
940><TABLE
941BORDER="0"
942WIDTH="100%"
943BGCOLOR="#FFD0D0"
944CELLSPACING="0"
945CELLPADDING="4"
946CLASS="CALSTABLE"
947><TBODY
948><TR
949><TD
950WIDTH="20%"
951ALIGN="RIGHT"
952VALIGN="TOP"
953><TT
954CLASS="PARAMETER"
955><I
956>str</I
957></TT
958>&nbsp;:</TD
959><TD
960WIDTH="80%"
961ALIGN="LEFT"
962VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]963> string to escape</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +0000[diff] [blame]964></TR
965><TR
966><TD
967WIDTH="20%"
968ALIGN="RIGHT"
969VALIGN="TOP"
970><TT
971CLASS="PARAMETER"
972><I
973>list</I
974></TT
975>&nbsp;:</TD
976><TD
977WIDTH="80%"
978ALIGN="LEFT"
979VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]980> exception list string of chars not to escape</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +0000[diff] [blame]981></TR
982><TR
983><TD
984WIDTH="20%"
985ALIGN="RIGHT"
986VALIGN="TOP"
987><I
988CLASS="EMPHASIS"
989>Returns</I
990> :</TD
991><TD
992WIDTH="80%"
993ALIGN="LEFT"
994VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]995>a new escaped string or NULL in case of error.</TD
Daniel Veillard4ec885a2001-06-17 10:31:07 +0000[diff] [blame]996></TR
997></TBODY
998></TABLE
999><P
1000></P
1001></DIV
1002></DIV
1003><HR><DIV
1004CLASS="REFSECT2"
1005><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1006NAME="AEN10364"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1007></A
1008><H3
1009><A
1010NAME="XMLURIUNESCAPESTRING"
1011></A
1012>xmlURIUnescapeString ()</H3
1013><TABLE
1014BORDER="0"
1015BGCOLOR="#D6E8FF"
1016WIDTH="100%"
1017CELLPADDING="6"
1018><TR
1019><TD
1020><PRE
1021CLASS="PROGRAMLISTING"
1022>char* xmlURIUnescapeString (const char *str,
1023 int len,
1024 char *target);</PRE
1025></TD
1026></TR
1027></TABLE
1028><P
1029>Unescaping routine, does not do validity checks !
1030Output is direct unsigned char translation of <TT
1031CLASS="LITERAL"
1032>XX</TT
1033> values (no encoding)</P
1034><P
1035></P
1036><DIV
1037CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1038><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1039NAME="AEN10371"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1040></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1041><P
1042></P
1043><TABLE
1044BORDER="0"
1045WIDTH="100%"
1046BGCOLOR="#FFD0D0"
1047CELLSPACING="0"
1048CELLPADDING="4"
1049CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1050><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1051><TR
1052><TD
1053WIDTH="20%"
1054ALIGN="RIGHT"
1055VALIGN="TOP"
1056><TT
1057CLASS="PARAMETER"
1058><I
1059>str</I
1060></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]1061>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1062><TD
1063WIDTH="80%"
1064ALIGN="LEFT"
1065VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1066> the string to unescape</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1067></TR
1068><TR
1069><TD
1070WIDTH="20%"
1071ALIGN="RIGHT"
1072VALIGN="TOP"
1073><TT
1074CLASS="PARAMETER"
1075><I
1076>len</I
1077></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]1078>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1079><TD
1080WIDTH="80%"
1081ALIGN="LEFT"
1082VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1083> the length in bytes to unescape (or &lt;= 0 to indicate full string)</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1084></TR
1085><TR
1086><TD
1087WIDTH="20%"
1088ALIGN="RIGHT"
1089VALIGN="TOP"
1090><TT
1091CLASS="PARAMETER"
1092><I
1093>target</I
1094></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]1095>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1096><TD
1097WIDTH="80%"
1098ALIGN="LEFT"
1099VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1100> optionnal destination buffer</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1101></TR
1102><TR
1103><TD
1104WIDTH="20%"
1105ALIGN="RIGHT"
1106VALIGN="TOP"
1107><I
1108CLASS="EMPHASIS"
1109>Returns</I
1110> :</TD
1111><TD
1112WIDTH="80%"
1113ALIGN="LEFT"
1114VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1115>an copy of the string, but unescaped</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1116></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1117></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1118></TABLE
1119><P
1120></P
1121></DIV
1122></DIV
1123><HR><DIV
1124CLASS="REFSECT2"
1125><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1126NAME="AEN10392"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1127></A
1128><H3
1129><A
1130NAME="XMLNORMALIZEURIPATH"
1131></A
1132>xmlNormalizeURIPath ()</H3
1133><TABLE
1134BORDER="0"
1135BGCOLOR="#D6E8FF"
1136WIDTH="100%"
1137CELLPADDING="6"
1138><TR
1139><TD
1140><PRE
1141CLASS="PROGRAMLISTING"
1142>int xmlNormalizeURIPath (char *path);</PRE
1143></TD
1144></TR
1145></TABLE
1146><P
Daniel Veillardd194dd22001-02-14 10:37:43 +0000[diff] [blame]1147>Applies the 5 normalization steps to a path string--that is, RFC 2396
1148Section 5.2, steps 6.c through 6.g.</P
1149><P
1150>Normalization occurs directly on the string, no new allocation is done</P
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1151><P
1152></P
1153><DIV
1154CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1155><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1156NAME="AEN10399"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1157></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1158><P
1159></P
1160><TABLE
1161BORDER="0"
1162WIDTH="100%"
1163BGCOLOR="#FFD0D0"
1164CELLSPACING="0"
1165CELLPADDING="4"
1166CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1167><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1168><TR
1169><TD
1170WIDTH="20%"
1171ALIGN="RIGHT"
1172VALIGN="TOP"
1173><TT
1174CLASS="PARAMETER"
1175><I
1176>path</I
1177></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]1178>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1179><TD
1180WIDTH="80%"
1181ALIGN="LEFT"
1182VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1183> pointer to the path string</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1184></TR
1185><TR
1186><TD
1187WIDTH="20%"
1188ALIGN="RIGHT"
1189VALIGN="TOP"
1190><I
1191CLASS="EMPHASIS"
1192>Returns</I
1193> :</TD
1194><TD
1195WIDTH="80%"
1196ALIGN="LEFT"
1197VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1198>0 or an error code</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1199></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1200></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1201></TABLE
1202><P
1203></P
1204></DIV
1205></DIV
1206><HR><DIV
1207CLASS="REFSECT2"
1208><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1209NAME="AEN10412"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1210></A
1211><H3
1212><A
1213NAME="XMLURIESCAPE"
1214></A
1215>xmlURIEscape ()</H3
1216><TABLE
1217BORDER="0"
1218BGCOLOR="#D6E8FF"
1219WIDTH="100%"
1220CELLPADDING="6"
1221><TR
1222><TD
1223><PRE
1224CLASS="PROGRAMLISTING"
1225><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1226HREF="libxml-tree.html#XMLCHAR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1227>xmlChar</A
1228>* xmlURIEscape (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1229HREF="libxml-tree.html#XMLCHAR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1230>xmlChar</A
1231> *str);</PRE
1232></TD
1233></TR
1234></TABLE
1235><P
1236>Escaping routine, does not do validity checks !
1237It will try to escape the chars needing this, but this is heuristic
1238based it's impossible to be sure.</P
1239><P
1240></P
1241><DIV
1242CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1243><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1244NAME="AEN10420"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1245></A
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1246><P
1247></P
1248><TABLE
1249BORDER="0"
1250WIDTH="100%"
1251BGCOLOR="#FFD0D0"
1252CELLSPACING="0"
1253CELLPADDING="4"
1254CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1255><TBODY
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1256><TR
1257><TD
1258WIDTH="20%"
1259ALIGN="RIGHT"
1260VALIGN="TOP"
1261><TT
1262CLASS="PARAMETER"
1263><I
1264>str</I
1265></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]1266>&nbsp;:</TD
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1267><TD
1268WIDTH="80%"
1269ALIGN="LEFT"
1270VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1271> the string of the URI to escape</TD
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1272></TR
1273><TR
1274><TD
1275WIDTH="20%"
1276ALIGN="RIGHT"
1277VALIGN="TOP"
1278><I
1279CLASS="EMPHASIS"
1280>Returns</I
1281> :</TD
1282><TD
1283WIDTH="80%"
1284ALIGN="LEFT"
1285VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1286>an copy of the string, but escaped
1287
128825 May 2001
1289Uses xmlParseURI and xmlURIEscapeStr to try to escape correctly
1290according to RFC2396.
1291- Carl Douglas</TD
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1292></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1293></TBODY
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1294></TABLE
1295><P
1296></P
1297></DIV
1298></DIV
1299><HR><DIV
1300CLASS="REFSECT2"
1301><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1302NAME="AEN10433"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1303></A
1304><H3
1305><A
1306NAME="XMLFREEURI"
1307></A
1308>xmlFreeURI ()</H3
1309><TABLE
1310BORDER="0"
1311BGCOLOR="#D6E8FF"
1312WIDTH="100%"
1313CELLPADDING="6"
1314><TR
1315><TD
1316><PRE
1317CLASS="PROGRAMLISTING"
1318>void xmlFreeURI (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1319HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1320>xmlURIPtr</A
1321> uri);</PRE
1322></TD
1323></TR
1324></TABLE
1325><P
1326>Free up the xmlURI struct</P
1327><P
1328></P
1329><DIV
1330CLASS="INFORMALTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1331><A
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1332NAME="AEN10440"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1333></A
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1334><P
1335></P
1336><TABLE
1337BORDER="0"
1338WIDTH="100%"
1339BGCOLOR="#FFD0D0"
1340CELLSPACING="0"
1341CELLPADDING="4"
1342CLASS="CALSTABLE"
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1343><TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1344><TR
1345><TD
1346WIDTH="20%"
1347ALIGN="RIGHT"
1348VALIGN="TOP"
1349><TT
1350CLASS="PARAMETER"
1351><I
1352>uri</I
1353></TT
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]1354>&nbsp;:</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1355><TD
1356WIDTH="80%"
1357ALIGN="LEFT"
1358VALIGN="TOP"
Daniel Veillardef90ba72001-12-07 14:24:22 +0000[diff] [blame^]1359> pointer to an xmlURI</TD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1360></TR
Daniel Veillardbed7b052001-05-19 14:59:49 +0000[diff] [blame]1361></TBODY
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1362></TABLE
1363><P
1364></P
1365></DIV
1366></DIV
1367></DIV
1368><DIV
1369CLASS="NAVFOOTER"
1370><BR
1371CLEAR="all"><BR><TABLE
1372WIDTH="100%"
1373BORDER="0"
1374BGCOLOR="#000000"
1375CELLPADDING="1"
1376CELLSPACING="0"
1377><TR
1378><TD
1379WIDTH="25%"
1380BGCOLOR="#C00000"
1381ALIGN="left"
1382><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1383HREF="libxml-valid.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1384><FONT
1385COLOR="#FFFFFF"
1386SIZE="3"
1387><B
1388>&#60;&#60;&#60; Previous Page</B
1389></FONT
1390></A
1391></TD
1392><TD
1393WIDTH="25%"
1394BGCOLOR="#0000C0"
1395ALIGN="center"
1396><FONT
1397COLOR="#FFFFFF"
1398SIZE="3"
1399><B
1400><A
1401HREF="book1.html"
1402><FONT
1403COLOR="#FFFFFF"
1404SIZE="3"
1405><B
1406>Home</B
1407></FONT
1408></A
1409></B
1410></FONT
1411></TD
1412><TD
1413WIDTH="25%"
1414BGCOLOR="#00C000"
1415ALIGN="center"
1416><FONT
1417COLOR="#FFFFFF"
1418SIZE="3"
1419><B
1420><A
1421HREF="libxml-lib.html"
1422><FONT
1423COLOR="#FFFFFF"
1424SIZE="3"
1425><B
1426>Up</B
1427></FONT
1428></A
1429></B
1430></FONT
1431></TD
1432><TD
1433WIDTH="25%"
1434BGCOLOR="#C00000"
1435ALIGN="right"
1436><A
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]1437HREF="libxml-xmlerror.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1438><FONT
1439COLOR="#FFFFFF"
1440SIZE="3"
1441><B
1442>Next Page &#62;&#62;&#62;</B
1443></FONT
1444></A
1445></TD
1446></TR
1447><TR
1448><TD
1449COLSPAN="2"
1450ALIGN="left"
1451><FONT
1452COLOR="#FFFFFF"
1453SIZE="3"
1454><B
1455>valid</B
1456></FONT
1457></TD
1458><TD
1459COLSPAN="2"
1460ALIGN="right"
1461><FONT
1462COLOR="#FFFFFF"
1463SIZE="3"
1464><B
Daniel Veillard3bbbe6f2001-05-03 11:15:37 +0000[diff] [blame]1465>xmlerror</B
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1466></FONT
1467></TD
1468></TR
1469></TABLE
1470></DIV
1471></BODY
1472></HTML
1473>