This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

URI::WithBase(3)                     User Contributed Perl Documentation                    URI::WithBase(3)



NAME
       URI::WithBase - URIs which remember their base

SYNOPSIS
        $u1 = URI::WithBase->new($str, $base);
        $u2 = $u1->abs;

        $base = $u1->base;
        $u1->base( $new_base )

DESCRIPTION
       This module provides the "URI::WithBase" class.  Objects of this class are like "URI" objects, but
       can keep their base too.  The base represents the context where this URI was found and can be used to
       absolutize or relativize the URI.  All the methods described in URI are supported for "URI::WithBase"
       objects.

       The methods provided in addition to or modified from those of "URI" are:

       $uri = URI::WithBase->new($str, [$base])
           The constructor takes an optional base URI as the second argument.  If provided, this argument
           initializes the base attribute.

       $uri->base( [$new_base] )
           Can be used to get or set the value of the base attribute.  The return value, which is the old
           value, is a URI object or "undef".

       $uri->abs( [$base_uri] )
           The $base_uri argument is now made optional as the object carries its base with it.  A new object
           is returned even if $uri is already absolute (while plain URI objects simply return themselves in
           that case).

       $uri->rel( [$base_uri] )
           The $base_uri argument is now made optional as the object carries its base with it.  A new object
           is always returned.

SEE ALSO
       URI

COPYRIGHT
       Copyright 1998-2002 Gisle Aas.



perl v5.8.8                                      2004-01-14                                 URI::WithBase(3)