redhat man page for 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 provide 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 absolutize 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 a an optional base URI as the second argument.  If provided this argument initialize the base attribute.

       $uri->base( [$new_base] )
	   This method can be used to get or set the value of the base attribute.  The return value is the old value and will be an 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 will 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.0							    2002-05-09							  URI::WithBase(3)