URI::WithBase

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 repre-
       sents the context where this URI was found and can be used to absolu-
       tize or relativize the URI.  All the methods described in URI are sup-
       ported 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.6                       2004-01-14                  URI::WithBase(3)