blob: 89e3653567b808dbe183aefc59d62d32d48d30c6 [file] [log] [blame]
Owen Taylor3473f882001-02-23 17:55:21 +00001/**
Daniel Veillardbe586972003-11-18 20:56:51 +00002 * Summary: library of generic URI related routines
3 * Description: library of generic URI related routines
4 * Implements RFC 2396
Owen Taylor3473f882001-02-23 17:55:21 +00005 *
Daniel Veillardbe586972003-11-18 20:56:51 +00006 * Copy: See Copyright for the status of this software.
Owen Taylor3473f882001-02-23 17:55:21 +00007 *
Daniel Veillardbe586972003-11-18 20:56:51 +00008 * Author: Daniel Veillard
Owen Taylor3473f882001-02-23 17:55:21 +00009 */
10
11#ifndef __XML_URI_H__
12#define __XML_URI_H__
13
Igor Zlatkovic76874e42003-08-25 09:05:12 +000014#include <libxml/xmlversion.h>
Owen Taylor3473f882001-02-23 17:55:21 +000015#include <libxml/tree.h>
16
17#ifdef __cplusplus
18extern "C" {
19#endif
20
21/**
Daniel Veillardf69bb4b2001-05-19 13:24:56 +000022 * xmlURI:
Owen Taylor3473f882001-02-23 17:55:21 +000023 *
Daniel Veillardf69bb4b2001-05-19 13:24:56 +000024 * A parsed URI reference. This is a struct containing the various fields
Daniel Veillard61f26172002-03-12 18:46:39 +000025 * as described in RFC 2396 but separated for further processing.
Owen Taylor3473f882001-02-23 17:55:21 +000026 */
27typedef struct _xmlURI xmlURI;
28typedef xmlURI *xmlURIPtr;
29struct _xmlURI {
Daniel Veillardf69bb4b2001-05-19 13:24:56 +000030 char *scheme; /* the URI scheme */
31 char *opaque; /* opaque part */
32 char *authority; /* the authority part */
33 char *server; /* the server part */
34 char *user; /* the user part */
35 int port; /* the port number */
36 char *path; /* the path string */
37 char *query; /* the query string */
38 char *fragment; /* the fragment identifier */
Daniel Veillardbb6808e2001-10-29 23:59:27 +000039 int cleanup; /* parsing potentially unclean URI */
Owen Taylor3473f882001-02-23 17:55:21 +000040};
41
42/*
43 * This function is in tree.h:
44 * xmlChar * xmlNodeGetBase (xmlDocPtr doc,
45 * xmlNodePtr cur);
46 */
Igor Zlatkovic76874e42003-08-25 09:05:12 +000047XMLPUBFUN xmlURIPtr XMLCALL
48 xmlCreateURI (void);
49XMLPUBFUN xmlChar * XMLCALL
Daniel Veillard336a8e12005-08-07 10:46:19 +000050 xmlBuildURI (const xmlChar *URI,
51 const xmlChar *base);
William M. Brackf7789b12004-06-07 08:57:27 +000052XMLPUBFUN xmlChar * XMLCALL
53 xmlBuildRelativeURI (const xmlChar *URI,
Daniel Veillard336a8e12005-08-07 10:46:19 +000054 const xmlChar *base);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +000055XMLPUBFUN xmlURIPtr XMLCALL
56 xmlParseURI (const char *str);
Daniel Veillard336a8e12005-08-07 10:46:19 +000057XMLPUBFUN xmlURIPtr XMLCALL
58 xmlParseURIRaw (const char *str,
59 int raw);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +000060XMLPUBFUN int XMLCALL
61 xmlParseURIReference (xmlURIPtr uri,
Owen Taylor3473f882001-02-23 17:55:21 +000062 const char *str);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +000063XMLPUBFUN xmlChar * XMLCALL
64 xmlSaveUri (xmlURIPtr uri);
65XMLPUBFUN void XMLCALL
66 xmlPrintURI (FILE *stream,
Owen Taylor3473f882001-02-23 17:55:21 +000067 xmlURIPtr uri);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +000068XMLPUBFUN xmlChar * XMLCALL
69 xmlURIEscapeStr (const xmlChar *str,
Daniel Veillard8514c672001-05-23 10:29:12 +000070 const xmlChar *list);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +000071XMLPUBFUN char * XMLCALL
72 xmlURIUnescapeString (const char *str,
Owen Taylor3473f882001-02-23 17:55:21 +000073 int len,
74 char *target);
Igor Zlatkovicaa3cfbd2003-08-27 08:59:58 +000075XMLPUBFUN int XMLCALL
76 xmlNormalizeURIPath (char *path);
77XMLPUBFUN xmlChar * XMLCALL
78 xmlURIEscape (const xmlChar *str);
79XMLPUBFUN void XMLCALL
80 xmlFreeURI (xmlURIPtr uri);
81XMLPUBFUN xmlChar* XMLCALL
82 xmlCanonicPath (const xmlChar *path);
Owen Taylor3473f882001-02-23 17:55:21 +000083
84#ifdef __cplusplus
85}
86#endif
87#endif /* __XML_URI_H__ */