URI::WithBase (3)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/URI::WithBase.3pm".)

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 represents the context where this was found and can be used to absolutize or relativize the All the methods described in 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 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

COPYRIGHT

Copyright 1998-2002 Gisle Aas.