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.8			  2008-04-02		     URI::WithBase(3)