[Function] parse-uri

Package

ystok.uri

Signagure

parse-uri string &key decode query-char-p fragment-char-p => uri

Arguments
string
A string representation of a URI.
decode
An external format designator, t (default), or nil
.
query-char-p
A predicate extending the set of characters allowed in the query part.
Defaults to *query-char-p*.
fragment-char-p
A predicate extending the set of characters allowed in the fragment part.
Defaults to *query-char-p*.
Values

An instance of the uri structure class.

Description

Convert string to a URI object.

decode controls whether string contains percent-encoded characters and what external format should be used in decode it. It can be one of the following:

external format
an external format designator, passed to percent-decode,
t
refers to the value of *default-external-format*,
nil
do not call percent-decode at all.

The function carefully separates parts as well as subparts within the path and query before percent decoding them.

In case string is badly formed, the uri-parse-error condition is signaled.