back

url

Description:

Basic facilities for parsing RFC 1739 Uniform Resource Locators

Author:

felix

Version:

Usage:

(require-extension url)

Download:

url.egg

Requires:

uri

Documentation:

[procedure] (url? X)

Returns #t if X is an URL object, or #f otherwise.

[procedure] (url STRING)

Parses the Uniform Resource Locator (RFC1738) STRING and returns an URL object. Encodings of the form %NN and occurrences of + are properly handled.

[procedure] (make-url #!key scheme user password host port path typecode)

Creates an URL object from its components. Any of the keyword parameters may be #f.

[procedure] (url-scheme URL)
[procedure] (url-user URL)
[procedure] (url-password URL)
[procedure] (url-host URL)
[procedure] (url-port URL)
[procedure] (url-path URL)
[procedure] (url-typecode URL)

Accessor procedures for URL objects that return the components of a parsed URL. All components are strings, with the exception of the port (an integer) and the typecode (a character).

[procedure] (url->string URL)

Returns a string-representation if the URL object URL.

[procedure] (url-decode STRING)

Replaces occurrences of %XX sequences in STRING with the respective characters.

[procedure] (url-encode STRING [CHARLIST])

Replaces occurrences of characters which are non-alphanumeric and do not appear in the list of characters given in the optional argument CHARLIST by their character code in %XX format.

License:

Portions Copyright (c) 2003-2005, Felix L. Winkelmann
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following
conditions are met:

  Redistributions of source code must retain the above copyright notice, this list of conditions and the following
    disclaimer.
  Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
    disclaimer in the documentation and/or other materials provided with the distribution.
  Neither the name of the author nor the names of its contributors may be used to endorse or promote
    products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
back