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.

Created 2001.8.1.