URI::WithBase
URI::WithBase - URIs which remember their base
$u1 = URI::WithBase->new($str, $base);
$u2 = $u1->abs;
$base = $u1->base;
$u1->base( $new_base )
This module provide 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 the URI manpage
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 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.
the URI manpage
Copyright 1998-2002 Gisle Aas.