Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / libxml2 / 146c9120ca81307e9cff8fa9bf3d056314934467 / . / doc / html / libxml-uri.html
blob: 0388b67ac5a4f8f97c23b820dc84a36088a01823 [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 Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]7CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]8REL="HOME"
9TITLE="Gnome XML Library Reference Manual"
10HREF="book1.html"><LINK
11REL="UP"
12TITLE="Libxml Library Reference"
13HREF="libxml-lib.html"><LINK
14REL="PREVIOUS"
15TITLE="valid"
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]16HREF="libxml-valid.html"><LINK
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]17REL="NEXT"
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]18TITLE="HTMLparser"
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]19HREF="libxml-htmlparser.html"></HEAD
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]20><BODY
21BGCOLOR="#FFFFFF"
22TEXT="#000000"
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]23LINK="#0000FF"
24VLINK="#840084"
25ALINK="#0000FF"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]26><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 +0000[diff] [blame]50HREF="libxml-valid.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]51><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 +0000[diff] [blame]104HREF="libxml-htmlparser.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]105><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 +0000[diff] [blame]117><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]118NAME="LIBXML-URI"
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]119>uri</A
120></H1
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]121><DIV
122CLASS="REFNAMEDIV"
123><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]124NAME="AEN9363"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]125></A
126><H2
127>Name</H2
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]128>uri&nbsp;--&nbsp;</DIV
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]129><DIV
130CLASS="REFSYNOPSISDIV"
131><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]132NAME="AEN9366"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]133></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 +0000[diff] [blame]148HREF="libxml-uri.html#XMLURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]149>xmlURI</A
150>;
151typedef <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]152HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]153>xmlURIPtr</A
154>;
155<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]156HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]157>xmlURIPtr</A
158> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]159HREF="libxml-uri.html#XMLCREATEURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]160>xmlCreateURI</A
161> (void);
162<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]163HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]164>xmlChar</A
165>* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]166HREF="libxml-uri.html#XMLBUILDURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]167>xmlBuildURI</A
168> (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]169HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]170>xmlChar</A
171> *URI,
172 const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]173HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]174>xmlChar</A
175> *base);
176<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]177HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]178>xmlURIPtr</A
179> <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]180HREF="libxml-uri.html#XMLPARSEURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]181>xmlParseURI</A
182> (const char *URI);
183int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]184HREF="libxml-uri.html#XMLPARSEURIREFERENCE"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]185>xmlParseURIReference</A
186> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]187HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]188>xmlURIPtr</A
189> uri,
190 const char *str);
191<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]192HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]193>xmlChar</A
194>* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]195HREF="libxml-uri.html#XMLSAVEURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]196>xmlSaveUri</A
197> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]198HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]199>xmlURIPtr</A
200> uri);
201void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]202HREF="libxml-uri.html#XMLPRINTURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]203>xmlPrintURI</A
204> (<GTKDOCLINK
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]205HREF="FILE-CAPS"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]206>FILE</GTKDOCLINK
207> *stream,
208 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]209HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]210>xmlURIPtr</A
211> uri);
212char* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]213HREF="libxml-uri.html#XMLURIUNESCAPESTRING"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]214>xmlURIUnescapeString</A
215> (const char *str,
216 int len,
217 char *target);
218int <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]219HREF="libxml-uri.html#XMLNORMALIZEURIPATH"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]220>xmlNormalizeURIPath</A
221> (char *path);
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]222<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]223HREF="libxml-tree.html#XMLCHAR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]224>xmlChar</A
225>* <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]226HREF="libxml-uri.html#XMLURIESCAPE"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]227>xmlURIEscape</A
228> (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]229HREF="libxml-tree.html#XMLCHAR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]230>xmlChar</A
231> *str);
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]232void <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]233HREF="libxml-uri.html#XMLFREEURI"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]234>xmlFreeURI</A
235> (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]236HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]237>xmlURIPtr</A
238> uri);</PRE
239></TD
240></TR
241></TABLE
242></DIV
243><DIV
244CLASS="REFSECT1"
245><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]246NAME="AEN9394"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]247></A
248><H2
249>Description</H2
250><P
251></P
252></DIV
253><DIV
254CLASS="REFSECT1"
255><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]256NAME="AEN9397"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]257></A
258><H2
259>Details</H2
260><DIV
261CLASS="REFSECT2"
262><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]263NAME="AEN9399"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]264></A
265><H3
266><A
267NAME="XMLURI"
268></A
269>struct xmlURI</H3
270><TABLE
271BORDER="0"
272BGCOLOR="#D6E8FF"
273WIDTH="100%"
274CELLPADDING="6"
275><TR
276><TD
277><PRE
278CLASS="PROGRAMLISTING"
279>struct xmlURI {
280 char *scheme;
281 char *opaque;
282 char *authority;
283 char *server;
284 char *user;
285 int port;
286 char *path;
287 char *query;
288 char *fragment;
289};</PRE
290></TD
291></TR
292></TABLE
293><P
294></P
295></DIV
296><HR><DIV
297CLASS="REFSECT2"
298><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]299NAME="AEN9404"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]300></A
301><H3
302><A
303NAME="XMLURIPTR"
304></A
305>xmlURIPtr</H3
306><TABLE
307BORDER="0"
308BGCOLOR="#D6E8FF"
309WIDTH="100%"
310CELLPADDING="6"
311><TR
312><TD
313><PRE
314CLASS="PROGRAMLISTING"
315>typedef xmlURI *xmlURIPtr;</PRE
316></TD
317></TR
318></TABLE
319><P
320></P
321></DIV
322><HR><DIV
323CLASS="REFSECT2"
324><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]325NAME="AEN9409"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]326></A
327><H3
328><A
329NAME="XMLCREATEURI"
330></A
331>xmlCreateURI ()</H3
332><TABLE
333BORDER="0"
334BGCOLOR="#D6E8FF"
335WIDTH="100%"
336CELLPADDING="6"
337><TR
338><TD
339><PRE
340CLASS="PROGRAMLISTING"
341><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]342HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]343>xmlURIPtr</A
344> xmlCreateURI (void);</PRE
345></TD
346></TR
347></TABLE
348><P
349>Simply creates an empty xmlURI</P
350><P
351></P
352><DIV
353CLASS="INFORMALTABLE"
354><P
355></P
356><TABLE
357BORDER="0"
358WIDTH="100%"
359BGCOLOR="#FFD0D0"
360CELLSPACING="0"
361CELLPADDING="4"
362CLASS="CALSTABLE"
363><TR
364><TD
365WIDTH="20%"
366ALIGN="RIGHT"
367VALIGN="TOP"
368><I
369CLASS="EMPHASIS"
370>Returns</I
371> :</TD
372><TD
373WIDTH="80%"
374ALIGN="LEFT"
375VALIGN="TOP"
376>the new structure or NULL in case of error</TD
377></TR
378></TABLE
379><P
380></P
381></DIV
382></DIV
383><HR><DIV
384CLASS="REFSECT2"
385><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]386NAME="AEN9425"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]387></A
388><H3
389><A
390NAME="XMLBUILDURI"
391></A
392>xmlBuildURI ()</H3
393><TABLE
394BORDER="0"
395BGCOLOR="#D6E8FF"
396WIDTH="100%"
397CELLPADDING="6"
398><TR
399><TD
400><PRE
401CLASS="PROGRAMLISTING"
402><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]403HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]404>xmlChar</A
405>* xmlBuildURI (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]406HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]407>xmlChar</A
408> *URI,
409 const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]410HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]411>xmlChar</A
412> *base);</PRE
413></TD
414></TR
415></TABLE
416><P
417>Computes he final URI of the reference done by checking that
418the given URI is valid, and building the final URI using the
419base URI. This is processed according to section 5.2 of the
420RFC 2396</P
421><P
422>5.2. Resolving Relative References to Absolute Form</P
423><P
424></P
425><DIV
426CLASS="INFORMALTABLE"
427><P
428></P
429><TABLE
430BORDER="0"
431WIDTH="100%"
432BGCOLOR="#FFD0D0"
433CELLSPACING="0"
434CELLPADDING="4"
435CLASS="CALSTABLE"
436><TR
437><TD
438WIDTH="20%"
439ALIGN="RIGHT"
440VALIGN="TOP"
441><TT
442CLASS="PARAMETER"
443><I
444>URI</I
445></TT
446>&nbsp;:</TD
447><TD
448WIDTH="80%"
449ALIGN="LEFT"
450VALIGN="TOP"
451> the URI instance found in the document</TD
452></TR
453><TR
454><TD
455WIDTH="20%"
456ALIGN="RIGHT"
457VALIGN="TOP"
458><TT
459CLASS="PARAMETER"
460><I
461>base</I
462></TT
463>&nbsp;:</TD
464><TD
465WIDTH="80%"
466ALIGN="LEFT"
467VALIGN="TOP"
468> the base value</TD
469></TR
470><TR
471><TD
472WIDTH="20%"
473ALIGN="RIGHT"
474VALIGN="TOP"
475><I
476CLASS="EMPHASIS"
477>Returns</I
478> :</TD
479><TD
480WIDTH="80%"
481ALIGN="LEFT"
482VALIGN="TOP"
483>a new URI string (to be freed by the caller) or NULL in case
484of error.</TD
485></TR
486></TABLE
487><P
488></P
489></DIV
490></DIV
491><HR><DIV
492CLASS="REFSECT2"
493><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]494NAME="AEN9452"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]495></A
496><H3
497><A
498NAME="XMLPARSEURI"
499></A
500>xmlParseURI ()</H3
501><TABLE
502BORDER="0"
503BGCOLOR="#D6E8FF"
504WIDTH="100%"
505CELLPADDING="6"
506><TR
507><TD
508><PRE
509CLASS="PROGRAMLISTING"
510><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]511HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]512>xmlURIPtr</A
513> xmlParseURI (const char *URI);</PRE
514></TD
515></TR
516></TABLE
517><P
518>Parse an URI </P
519><P
520>URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]</P
521><P
522></P
523><DIV
524CLASS="INFORMALTABLE"
525><P
526></P
527><TABLE
528BORDER="0"
529WIDTH="100%"
530BGCOLOR="#FFD0D0"
531CELLSPACING="0"
532CELLPADDING="4"
533CLASS="CALSTABLE"
534><TR
535><TD
536WIDTH="20%"
537ALIGN="RIGHT"
538VALIGN="TOP"
539><TT
540CLASS="PARAMETER"
541><I
542>URI</I
543></TT
544>&nbsp;:</TD
545><TD
546WIDTH="80%"
547ALIGN="LEFT"
548VALIGN="TOP"
549>&nbsp;</TD
550></TR
551><TR
552><TD
553WIDTH="20%"
554ALIGN="RIGHT"
555VALIGN="TOP"
556><I
557CLASS="EMPHASIS"
558>Returns</I
559> :</TD
560><TD
561WIDTH="80%"
562ALIGN="LEFT"
563VALIGN="TOP"
564>a newly build xmlURIPtr or NULL in case of error</TD
565></TR
566></TABLE
567><P
568></P
569></DIV
570></DIV
571><HR><DIV
572CLASS="REFSECT2"
573><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]574NAME="AEN9473"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]575></A
576><H3
577><A
578NAME="XMLPARSEURIREFERENCE"
579></A
580>xmlParseURIReference ()</H3
581><TABLE
582BORDER="0"
583BGCOLOR="#D6E8FF"
584WIDTH="100%"
585CELLPADDING="6"
586><TR
587><TD
588><PRE
589CLASS="PROGRAMLISTING"
590>int xmlParseURIReference (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]591HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]592>xmlURIPtr</A
593> uri,
594 const char *str);</PRE
595></TD
596></TR
597></TABLE
598><P
599>Parse an URI reference string and fills in the appropriate fields
600of the <TT
601CLASS="PARAMETER"
602><I
603>uri</I
604></TT
605> structure</P
606><P
607>URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]</P
608><P
609></P
610><DIV
611CLASS="INFORMALTABLE"
612><P
613></P
614><TABLE
615BORDER="0"
616WIDTH="100%"
617BGCOLOR="#FFD0D0"
618CELLSPACING="0"
619CELLPADDING="4"
620CLASS="CALSTABLE"
621><TR
622><TD
623WIDTH="20%"
624ALIGN="RIGHT"
625VALIGN="TOP"
626><TT
627CLASS="PARAMETER"
628><I
629>uri</I
630></TT
631>&nbsp;:</TD
632><TD
633WIDTH="80%"
634ALIGN="LEFT"
635VALIGN="TOP"
636> pointer to an URI structure</TD
637></TR
638><TR
639><TD
640WIDTH="20%"
641ALIGN="RIGHT"
642VALIGN="TOP"
643><TT
644CLASS="PARAMETER"
645><I
646>str</I
647></TT
648>&nbsp;:</TD
649><TD
650WIDTH="80%"
651ALIGN="LEFT"
652VALIGN="TOP"
653> the string to analyze</TD
654></TR
655><TR
656><TD
657WIDTH="20%"
658ALIGN="RIGHT"
659VALIGN="TOP"
660><I
661CLASS="EMPHASIS"
662>Returns</I
663> :</TD
664><TD
665WIDTH="80%"
666ALIGN="LEFT"
667VALIGN="TOP"
668>0 or the error code</TD
669></TR
670></TABLE
671><P
672></P
673></DIV
674></DIV
675><HR><DIV
676CLASS="REFSECT2"
677><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]678NAME="AEN9499"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]679></A
680><H3
681><A
682NAME="XMLSAVEURI"
683></A
684>xmlSaveUri ()</H3
685><TABLE
686BORDER="0"
687BGCOLOR="#D6E8FF"
688WIDTH="100%"
689CELLPADDING="6"
690><TR
691><TD
692><PRE
693CLASS="PROGRAMLISTING"
694><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]695HREF="libxml-tree.html#XMLCHAR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]696>xmlChar</A
697>* xmlSaveUri (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]698HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]699>xmlURIPtr</A
700> uri);</PRE
701></TD
702></TR
703></TABLE
704><P
705>Save the URI as an escaped string</P
706><P
707></P
708><DIV
709CLASS="INFORMALTABLE"
710><P
711></P
712><TABLE
713BORDER="0"
714WIDTH="100%"
715BGCOLOR="#FFD0D0"
716CELLSPACING="0"
717CELLPADDING="4"
718CLASS="CALSTABLE"
719><TR
720><TD
721WIDTH="20%"
722ALIGN="RIGHT"
723VALIGN="TOP"
724><TT
725CLASS="PARAMETER"
726><I
727>uri</I
728></TT
729>&nbsp;:</TD
730><TD
731WIDTH="80%"
732ALIGN="LEFT"
733VALIGN="TOP"
734> pointer to an xmlURI</TD
735></TR
736><TR
737><TD
738WIDTH="20%"
739ALIGN="RIGHT"
740VALIGN="TOP"
741><I
742CLASS="EMPHASIS"
743>Returns</I
744> :</TD
745><TD
746WIDTH="80%"
747ALIGN="LEFT"
748VALIGN="TOP"
749>a new string (to be deallocated by caller)</TD
750></TR
751></TABLE
752><P
753></P
754></DIV
755></DIV
756><HR><DIV
757CLASS="REFSECT2"
758><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]759NAME="AEN9520"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]760></A
761><H3
762><A
763NAME="XMLPRINTURI"
764></A
765>xmlPrintURI ()</H3
766><TABLE
767BORDER="0"
768BGCOLOR="#D6E8FF"
769WIDTH="100%"
770CELLPADDING="6"
771><TR
772><TD
773><PRE
774CLASS="PROGRAMLISTING"
775>void xmlPrintURI (<GTKDOCLINK
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]776HREF="FILE-CAPS"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]777>FILE</GTKDOCLINK
778> *stream,
779 <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]780HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]781>xmlURIPtr</A
782> uri);</PRE
783></TD
784></TR
785></TABLE
786><P
787>Prints the URI in the stream <TT
788CLASS="PARAMETER"
789><I
790>steam</I
791></TT
792>.</P
793><P
794></P
795><DIV
796CLASS="INFORMALTABLE"
797><P
798></P
799><TABLE
800BORDER="0"
801WIDTH="100%"
802BGCOLOR="#FFD0D0"
803CELLSPACING="0"
804CELLPADDING="4"
805CLASS="CALSTABLE"
806><TR
807><TD
808WIDTH="20%"
809ALIGN="RIGHT"
810VALIGN="TOP"
811><TT
812CLASS="PARAMETER"
813><I
814>stream</I
815></TT
816>&nbsp;:</TD
817><TD
818WIDTH="80%"
819ALIGN="LEFT"
820VALIGN="TOP"
821> a FILE* for the output</TD
822></TR
823><TR
824><TD
825WIDTH="20%"
826ALIGN="RIGHT"
827VALIGN="TOP"
828><TT
829CLASS="PARAMETER"
830><I
831>uri</I
832></TT
833>&nbsp;:</TD
834><TD
835WIDTH="80%"
836ALIGN="LEFT"
837VALIGN="TOP"
838> pointer to an xmlURI</TD
839></TR
840></TABLE
841><P
842></P
843></DIV
844></DIV
845><HR><DIV
846CLASS="REFSECT2"
847><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]848NAME="AEN9542"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]849></A
850><H3
851><A
852NAME="XMLURIUNESCAPESTRING"
853></A
854>xmlURIUnescapeString ()</H3
855><TABLE
856BORDER="0"
857BGCOLOR="#D6E8FF"
858WIDTH="100%"
859CELLPADDING="6"
860><TR
861><TD
862><PRE
863CLASS="PROGRAMLISTING"
864>char* xmlURIUnescapeString (const char *str,
865 int len,
866 char *target);</PRE
867></TD
868></TR
869></TABLE
870><P
871>Unescaping routine, does not do validity checks !
872Output is direct unsigned char translation of <TT
873CLASS="LITERAL"
874>XX</TT
875> values (no encoding)</P
876><P
877></P
878><DIV
879CLASS="INFORMALTABLE"
880><P
881></P
882><TABLE
883BORDER="0"
884WIDTH="100%"
885BGCOLOR="#FFD0D0"
886CELLSPACING="0"
887CELLPADDING="4"
888CLASS="CALSTABLE"
889><TR
890><TD
891WIDTH="20%"
892ALIGN="RIGHT"
893VALIGN="TOP"
894><TT
895CLASS="PARAMETER"
896><I
897>str</I
898></TT
899>&nbsp;:</TD
900><TD
901WIDTH="80%"
902ALIGN="LEFT"
903VALIGN="TOP"
904> the string to unescape</TD
905></TR
906><TR
907><TD
908WIDTH="20%"
909ALIGN="RIGHT"
910VALIGN="TOP"
911><TT
912CLASS="PARAMETER"
913><I
914>len</I
915></TT
916>&nbsp;:</TD
917><TD
918WIDTH="80%"
919ALIGN="LEFT"
920VALIGN="TOP"
921> the lenght in bytes to unescape (or &lt;= 0 to indicate full string)</TD
922></TR
923><TR
924><TD
925WIDTH="20%"
926ALIGN="RIGHT"
927VALIGN="TOP"
928><TT
929CLASS="PARAMETER"
930><I
931>target</I
932></TT
933>&nbsp;:</TD
934><TD
935WIDTH="80%"
936ALIGN="LEFT"
937VALIGN="TOP"
938> optionnal destination buffer</TD
939></TR
940><TR
941><TD
942WIDTH="20%"
943ALIGN="RIGHT"
944VALIGN="TOP"
945><I
946CLASS="EMPHASIS"
947>Returns</I
948> :</TD
949><TD
950WIDTH="80%"
951ALIGN="LEFT"
952VALIGN="TOP"
953>an copy of the string, but unescaped</TD
954></TR
955></TABLE
956><P
957></P
958></DIV
959></DIV
960><HR><DIV
961CLASS="REFSECT2"
962><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]963NAME="AEN9570"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]964></A
965><H3
966><A
967NAME="XMLNORMALIZEURIPATH"
968></A
969>xmlNormalizeURIPath ()</H3
970><TABLE
971BORDER="0"
972BGCOLOR="#D6E8FF"
973WIDTH="100%"
974CELLPADDING="6"
975><TR
976><TD
977><PRE
978CLASS="PROGRAMLISTING"
979>int xmlNormalizeURIPath (char *path);</PRE
980></TD
981></TR
982></TABLE
983><P
Daniel Veillardd194dd22001-02-14 10:37:43 +0000[diff] [blame]984>Applies the 5 normalization steps to a path string--that is, RFC 2396
985Section 5.2, steps 6.c through 6.g.</P
986><P
987>Normalization occurs directly on the string, no new allocation is done</P
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]988><P
989></P
990><DIV
991CLASS="INFORMALTABLE"
992><P
993></P
994><TABLE
995BORDER="0"
996WIDTH="100%"
997BGCOLOR="#FFD0D0"
998CELLSPACING="0"
999CELLPADDING="4"
1000CLASS="CALSTABLE"
1001><TR
1002><TD
1003WIDTH="20%"
1004ALIGN="RIGHT"
1005VALIGN="TOP"
1006><TT
1007CLASS="PARAMETER"
1008><I
1009>path</I
1010></TT
1011>&nbsp;:</TD
1012><TD
1013WIDTH="80%"
1014ALIGN="LEFT"
1015VALIGN="TOP"
1016> pointer to the path string</TD
1017></TR
1018><TR
1019><TD
1020WIDTH="20%"
1021ALIGN="RIGHT"
1022VALIGN="TOP"
1023><I
1024CLASS="EMPHASIS"
1025>Returns</I
1026> :</TD
1027><TD
1028WIDTH="80%"
1029ALIGN="LEFT"
1030VALIGN="TOP"
1031>0 or an error code</TD
1032></TR
1033></TABLE
1034><P
1035></P
1036></DIV
1037></DIV
1038><HR><DIV
1039CLASS="REFSECT2"
1040><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]1041NAME="AEN9590"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1042></A
1043><H3
1044><A
1045NAME="XMLURIESCAPE"
1046></A
1047>xmlURIEscape ()</H3
1048><TABLE
1049BORDER="0"
1050BGCOLOR="#D6E8FF"
1051WIDTH="100%"
1052CELLPADDING="6"
1053><TR
1054><TD
1055><PRE
1056CLASS="PROGRAMLISTING"
1057><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1058HREF="libxml-tree.html#XMLCHAR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1059>xmlChar</A
1060>* xmlURIEscape (const <A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1061HREF="libxml-tree.html#XMLCHAR"
Daniel Veillard28929b22000-11-13 18:22:49 +0000[diff] [blame]1062>xmlChar</A
1063> *str);</PRE
1064></TD
1065></TR
1066></TABLE
1067><P
1068>Escaping routine, does not do validity checks !
1069It will try to escape the chars needing this, but this is heuristic
1070based it's impossible to be sure.</P
1071><P
1072></P
1073><DIV
1074CLASS="INFORMALTABLE"
1075><P
1076></P
1077><TABLE
1078BORDER="0"
1079WIDTH="100%"
1080BGCOLOR="#FFD0D0"
1081CELLSPACING="0"
1082CELLPADDING="4"
1083CLASS="CALSTABLE"
1084><TR
1085><TD
1086WIDTH="20%"
1087ALIGN="RIGHT"
1088VALIGN="TOP"
1089><TT
1090CLASS="PARAMETER"
1091><I
1092>str</I
1093></TT
1094>&nbsp;:</TD
1095><TD
1096WIDTH="80%"
1097ALIGN="LEFT"
1098VALIGN="TOP"
1099> the string of the URI to escape</TD
1100></TR
1101><TR
1102><TD
1103WIDTH="20%"
1104ALIGN="RIGHT"
1105VALIGN="TOP"
1106><I
1107CLASS="EMPHASIS"
1108>Returns</I
1109> :</TD
1110><TD
1111WIDTH="80%"
1112ALIGN="LEFT"
1113VALIGN="TOP"
1114>an copy of the string, but escaped</TD
1115></TR
1116></TABLE
1117><P
1118></P
1119></DIV
1120></DIV
1121><HR><DIV
1122CLASS="REFSECT2"
1123><A
Daniel Veillarde356c282001-03-10 12:32:04 +0000[diff] [blame]1124NAME="AEN9611"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1125></A
1126><H3
1127><A
1128NAME="XMLFREEURI"
1129></A
1130>xmlFreeURI ()</H3
1131><TABLE
1132BORDER="0"
1133BGCOLOR="#D6E8FF"
1134WIDTH="100%"
1135CELLPADDING="6"
1136><TR
1137><TD
1138><PRE
1139CLASS="PROGRAMLISTING"
1140>void xmlFreeURI (<A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1141HREF="libxml-uri.html#XMLURIPTR"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1142>xmlURIPtr</A
1143> uri);</PRE
1144></TD
1145></TR
1146></TABLE
1147><P
1148>Free up the xmlURI struct</P
1149><P
1150></P
1151><DIV
1152CLASS="INFORMALTABLE"
1153><P
1154></P
1155><TABLE
1156BORDER="0"
1157WIDTH="100%"
1158BGCOLOR="#FFD0D0"
1159CELLSPACING="0"
1160CELLPADDING="4"
1161CLASS="CALSTABLE"
1162><TR
1163><TD
1164WIDTH="20%"
1165ALIGN="RIGHT"
1166VALIGN="TOP"
1167><TT
1168CLASS="PARAMETER"
1169><I
1170>uri</I
1171></TT
1172>&nbsp;:</TD
1173><TD
1174WIDTH="80%"
1175ALIGN="LEFT"
1176VALIGN="TOP"
1177> pointer to an xmlURI</TD
1178></TR
1179></TABLE
1180><P
1181></P
1182></DIV
1183></DIV
1184></DIV
1185><DIV
1186CLASS="NAVFOOTER"
1187><BR
1188CLEAR="all"><BR><TABLE
1189WIDTH="100%"
1190BORDER="0"
1191BGCOLOR="#000000"
1192CELLPADDING="1"
1193CELLSPACING="0"
1194><TR
1195><TD
1196WIDTH="25%"
1197BGCOLOR="#C00000"
1198ALIGN="left"
1199><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1200HREF="libxml-valid.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1201><FONT
1202COLOR="#FFFFFF"
1203SIZE="3"
1204><B
1205>&#60;&#60;&#60; Previous Page</B
1206></FONT
1207></A
1208></TD
1209><TD
1210WIDTH="25%"
1211BGCOLOR="#0000C0"
1212ALIGN="center"
1213><FONT
1214COLOR="#FFFFFF"
1215SIZE="3"
1216><B
1217><A
1218HREF="book1.html"
1219><FONT
1220COLOR="#FFFFFF"
1221SIZE="3"
1222><B
1223>Home</B
1224></FONT
1225></A
1226></B
1227></FONT
1228></TD
1229><TD
1230WIDTH="25%"
1231BGCOLOR="#00C000"
1232ALIGN="center"
1233><FONT
1234COLOR="#FFFFFF"
1235SIZE="3"
1236><B
1237><A
1238HREF="libxml-lib.html"
1239><FONT
1240COLOR="#FFFFFF"
1241SIZE="3"
1242><B
1243>Up</B
1244></FONT
1245></A
1246></B
1247></FONT
1248></TD
1249><TD
1250WIDTH="25%"
1251BGCOLOR="#C00000"
1252ALIGN="right"
1253><A
Daniel Veillard9cb5ff42001-01-29 08:22:21 +0000[diff] [blame]1254HREF="libxml-htmlparser.html"
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1255><FONT
1256COLOR="#FFFFFF"
1257SIZE="3"
1258><B
1259>Next Page &#62;&#62;&#62;</B
1260></FONT
1261></A
1262></TD
1263></TR
1264><TR
1265><TD
1266COLSPAN="2"
1267ALIGN="left"
1268><FONT
1269COLOR="#FFFFFF"
1270SIZE="3"
1271><B
1272>valid</B
1273></FONT
1274></TD
1275><TD
1276COLSPAN="2"
1277ALIGN="right"
1278><FONT
1279COLOR="#FFFFFF"
1280SIZE="3"
1281><B
Daniel Veillard503b8932001-01-05 06:36:31 +0000[diff] [blame]1282>HTMLparser</B
Daniel Veillardb732a0e2000-10-15 11:27:01 +0000[diff] [blame]1283></FONT
1284></TD
1285></TR
1286></TABLE
1287></DIV
1288></BODY
1289></HTML
1290>