* Summary: library of generic URI related routines
      * Description: library of generic URI related routines
      *              Implements RFC 2396
      *
      * Copy: See Copyright for the status of this software.
      *
      * Author: Patrick Monnerat <pm@datasphere.ch>, DATASPHERE S.A.

      /if not defined(XML_URI_H__)
      /define XML_URI_H__

      /include "libxmlrpg/xmlversion"
      /include "libxmlrpg/tree"

      * xmlURI:
      *
      * A parsed URI reference. This is a struct containing the various fields
      * as described in RFC 2396 but separated for further processing.
      *
      * Note: query is a deprecated field which is incorrectly unescaped.
      * query_raw takes precedence over query if the former is set.
      * See: http://mail.gnome.org/archives/xml/2007-April/thread.html#00127

     d xmlURIPtr       s               *   based(######typedef######)

     d xmlURI          ds                  based(xmlURIPtr)
     d                                     align qualified
     d  scheme                         *                                        char *
     d  opaque                         *                                        char *
     d  authority                      *                                        char *
     d  server                         *                                        char *
     d  user                           *                                        char *
     d  port                         10i 0
     d  path                           *                                        char *
     d  query                          *                                        char *
     d  fragment                       *                                        char *
     d  cleanup                      10i 0
     d  query_raw                      *                                        char *

     d xmlCreateURI    pr                  extproc('xmlCreateURI')
     d                                     like(xmlURIPtr)

     d xmlBuildURI     pr              *   extproc('xmlBuildURI')               xmlChar *
     d  URI                            *   value options(*string)               const xmlChar *
     d  base                           *   value options(*string)               const xmlChar *

     d xmlBuildRelativeURI...
     d                 pr              *   extproc('xmlBuildRelativeURI')       xmlChar *
     d  URI                            *   value options(*string)               const xmlChar *
     d  base                           *   value options(*string)               const xmlChar *

     d xmlParseURI     pr                  extproc('xmlParseURI')
     d                                     like(xmlURIPtr)
     d  str                            *   value options(*string)               const char *

     d xmlParseURIRaw  pr                  extproc('xmlParseURIRaw')
     d                                     like(xmlURIPtr)
     d  str                            *   value options(*string)               const char *
     d  raw                          10i 0 value

     d xmlParseURIReference...
     d                 pr            10i 0 extproc('xmlParseURIReference')
     d  uri                                value like(xmlURIPtr)
     d  str                            *   value options(*string)               const char *

     d xmlSaveUri      pr              *   extproc('xmlSaveUri')                xmlChar *
     d  uri                                value like(xmlURIPtr)

     d xmlPrintURI     pr                  extproc('xmlPrintURI')
     d  stream                         *   value                                FILE *
     d  uri                                value like(xmlURIPtr)

     d xmlURIEscapeStr...
     d                 pr              *   extproc('xmlURIEscapeStr')           xmlChar *
     d  str                            *   value options(*string)               const xmlChar *
     d  list                           *   value options(*string)               const xmlChar *

     d xmlURIUnescapeString...
     d                 pr              *   extproc('xmlURIUnescapeString')      char *
     d  str                            *   value options(*string)               const char *
     d  len                          10i 0 value
     d  target                         *   value options(*string)               char *

     d xmlNormalizeURIPath...
     d                 pr            10i 0 extproc('xmlNormalizeURIPath')
     d  path                           *   value options(*string)               char *

     d xmlURIEscape    pr              *   extproc('xmlURIEscape')              xmlChar *
     d  str                            *   value options(*string)               const xmlChar *

     d xmlFreeURI      pr                  extproc('xmlFreeURI')
     d  uri                                value like(xmlURIPtr)

     d xmlCanonicPath  pr              *   extproc('xmlCanonicPath')            xmlChar *
     d  path                           *   value options(*string)               const xmlChar *

     d xmlPathToURI    pr              *   extproc('xmlPathToURI')              xmlChar *
     d  path                           *   value options(*string)               const xmlChar *

      /endif                                                                    XML_URI_H__