URI::WithBase(3)

🌸 NAME 🌸

okay so bestie, the manual name is URI::WithBase, and it's literally 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 they can keep their base too 🫶 The base represents the context where this URI was found, and it can be used to absolutize or relativize the URI. All the methods described in URI are supported for URI::WithBase objects. periodt.

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

• $uri = URI::WithBase->new($str, [$base]) — the constructor, bestie 🎀 It takes an optional base URI as the second argument. If provided, this argument initializes the base attribute.
• $uri->base( [$new_base] ) — 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). not me calling out plain URI like that 😭
• $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 — go check it out, iykyk 👑

---

👑 COPYRIGHT 👑

Copyright 1998-2002 Gisle Aas.

---

💖 cute lil sign-off: this page is from perl v5.42.0, dated 2026-09-02, and it's literally URI::WithBase(3). mwah 🫶✨