=encoding euc-jp

=head1 NAME

=begin original

URI::WithBase - URIs which remember their base

=end original

URI::WithBase - ベースを覚えている URI

=head1 SYNOPSIS

 $u1 = URI::WithBase->new($str, $base);
 $u2 = $u1->abs;

 $base = $u1->base;
 $u1->base( $new_base )

=head1 DESCRIPTION

=begin original

This module provides the C<URI::WithBase> class.  Objects of this class
are like C<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 L<URI>
are supported for C<URI::WithBase> objects.

=end original

このモジュールは C<URI::WithBase> クラスを提供します。
このクラスのオブジェクトは C<URI> オブジェクトに似ていますが、その
ベースも保持します。
ベースは、この URI が見つかったコンテキストで、
URI の絶対化または相対化に使えます。
L<URI> で記述されている全てのメソッドは、
C<URI::WithBase> オブジェクトも対応しています。

=begin original

The methods provided in addition to or modified from those of C<URI> are:

=end original

C<URI> より追加あるいは修正されたメソッドは以下の通りです:

=over 4

=item $uri = URI::WithBase->new($str, [$base])

=begin original

The constructor takes an optional base URI as the second argument.
If provided, this argument initializes the base attribute.

=end original

コンストラクタはオプションのベース URI を 2 番目の引数として取ります。
引数が与えられると、これでベース属性を初期化します。

=item $uri->base( [$new_base] )

=begin original

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 C<undef>.

=end original

base 属性の値を取得あるいは設定するために使われます。
返り値は元の値で、URI オブジェクトか C<undef> です。

=item $uri->abs( [$base_uri] )

=begin original

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).

=end original

オブジェクトがベースを保持しているので、$base_uri 引数はオプションになります。
$uri が既に絶対表記でも、
(通常の URI オブジェクトはこの場合単に自分自身を返しますが)
新しいオブジェクトが返されます。

=item $uri->rel( [$base_uri] )

=begin original

The $base_uri argument is now made optional as the object carries its
base with it.  A new object is always returned.

=end original

オブジェクトがベースを保持しているので、$base_uri 引数はオプションになります。
新しいオブジェクトが常に返されます。

=back

=head1 SEE ALSO

L<URI>

=head1 COPYRIGHT

Copyright 1998-2002 Gisle Aas.

=begin meta

Translate: Hippo2000 <GCD00051@nifty.ne.jp> (1.04)
Update: SHIRAKATA Kentaro <argrath@ub32.org> (1.35)
Status: completed

=end meta

=cut