uri-parsed-path

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")) 

is

(: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.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.