GNU Info

(slib.info)URI

---

Next: Printing Scheme Prev: HTTP and CGI Up: Textual Conversion Packages

---

Enter node , (file) or (file)node

URI
===

  `(require 'uri)'

Implements "Uniform Resource Identifiers" (URI) as described in RFC
2396.

 - Function: make-uri
 - Function: make-uri fragment
 - Function: make-uri query fragment
 - Function: make-uri path query fragment
 - Function: make-uri authority path query fragment
 - Function: make-uri scheme authority path query fragment
     Returns a Uniform Resource Identifier string from component
     arguments.

 - Function: html:anchor name
     Returns a string which defines this location in the (HTML) file as
     NAME.  The hypertext `<A HREF="#NAME">' will link to this point.

          (html:anchor "(section 7)")
          =>
          "<A NAME=\"(section%207)\"></A>"

 - Function: html:link uri highlighted
     Returns a string which links the HIGHLIGHTED text to URI.

          (html:link (make-uri "(section 7)") "section 7")
          =>
          "<A HREF=\"#(section%207)\">section 7</A>"

 - Function: html:base uri
     Returns a string specifying the "base" URI of a document, for
     inclusion in the HEAD of the document (Note: head.).

 - Function: html:isindex prompt
     Returns a string specifying the search PROMPT of a document, for
     inclusion in the HEAD of the document (Note: head.).

 - Function: uri->tree uri-reference base-tree ...
     Returns a list of 5 elements corresponding to the parts (SCHEME
     AUTHORITY PATH QUERY FRAGMENT) of string URI-REFERENCE.  Elements
     corresponding to absent parts are #f.

     The PATH is a list of strings.  If the first string is empty, then
     the path is absolute; otherwise relative.

     If the AUTHORITY component is a "Server-based Naming Authority",
     then it is a list of the USERINFO, HOST, and PORT strings (or #f).
     For other types of AUTHORITY components the AUTHORITY will be a
     string.

          (uri->tree "http://www.ics.uci.edu/pub/ietf/uri/#Related")
          =>
          (http "www.ics.uci.edu" ("" "pub" "ietf" "uri" "") #f "Related")

`uric:' prefixes indicate procedures dealing with URI-components.

 - Function: uric:encode uri-component allows
     Returns a copy of the string URI-COMPONENT in which all "unsafe"
     octets (as defined in RFC 2396) have been `%' "escaped".
     `uric:decode' decodes strings encoded by `uric:encode'.

 - Function: uric:decode uri-component
     Returns a copy of the string URI-COMPONENT in which each `%'
     escaped characters in URI-COMPONENT is replaced with the character
     it encodes.  This routine is useful for showing URI contents on
     error pages.