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)
