uri-parsed-path

Generic Function

Arguments: uri

Return the parsed representation of the path portion of uri (as returned by uri-path. This is setf'able.

The parsed path representation is a list (the path is a string). A parsed path has the following form:

([:absolute | :relative] component1 [component2...])

where components are:

element | (element param1 [param2 ...])

and element is a path element, and the param's are path element parameters. For example, the result of

(uri-parsed-path (parse-uri "foo;10/bar:x;y;z/baz.htm"))

(:relative ("foo""10") 
           ("bar:x""y""z") 
           "baz.htm")

There is a certain amount of canonicalization that occurs when parsing:

A path of (:absolute) or (:absolute "") is equivalent to a nil path. That is, http://a/ is parsed with a nil path and printed as http://a.
Escaped characters that are not reserved are not escaped upon printing. For example, "foob%61r" is parsed into "foobar" and appears as "foobar" when the URI is printed.

See Parsing, escape decoding/encoding and the path in uri.htm for a discussion of encoding and decoding. The example above is repeated there.

See also uri.htm for general information on Universal Resource Indicator support in Allegro CL.

The documentation is described in introduction.htm and the index is in index.htm.

Created 2000.10.5.