Net::RD...:Address(3)

💌 NAME 💌

Net::RDAP::JCard::Address — it's a module, bestie, and it represents a postal address inside a Net::RDAP::JCard object. That's it, that's the job. 💅

Oh and btw, this whole thing is a page from the User Contributed Perl Documentation section, so you know it's the real deal. ✨

---

🦋 SYNOPSIS 🦋

okay so first you gotta get the jcard, like so:

#
# get an object by calling the jcard() method on a Net::RDAP::Object::Entity
#
my $jcard = $entity->jcard;

#
# get the first address. You can also uses $jcard->addresses() to get all
# ADR properties.
#
my $adr = $jcard->first_address;

if ($adr->structured) {
    #
    # This is a structured address so we can extract the individual components:
    #

    map { say "Street: ".$_ } @{$adr->street};
    say "Locality: ".$adr->locality;
    say "Region: ".$adr->region;
    say "Postal Code: ".$adr->code;
    say "Country: ".($adr->cc || $adr->country);

} else {
    #
    # This is an unstructured address, so just print it:
    #
    say "Address:".$adr->address;

}

see how there's two whole vibes in there? structured addresses let you pull out every little piece, and unstructured ones you just print as-is. both valid. both slay. 🫶

---

🌸 DESCRIPTION 🌸

so. postal addresses. the vCard representation (<https://www.rfc-editor.org/rfc/rfc6350.html#section-6.3.1>) and the jCard representation (<https://datatracker.ietf.org/doc/html/rfc7095#section-3.3.1.3>) are... a lot. like, genuinely a struggle. they are hard to deal with and they cause difficulties, and that's just the truth of it. 😭

so Net::RDAP::JCard::Address swoops in with an ergonomic interface to "ADR" properties inside jCard objects. your wrists will thank you.

and to actually get one of these bad boys? use the first_address() or addresses() methods of Net::RDAP::JCard — they hand you back an array of address objects. 🎀

---

👑 METHODS 👑

Net::RDAP::JCard::Address inherits from Net::RDAP::JCard::Property, so it's already got all of that module's methods (iconic behaviour, honestly), plus everything below. 👇

✨ ADDRESS TYPE ✨

$structured = $adr->structured;

returns true if the address is "structured" — and if you want the full lore on that, it's Section 3.3.1.3 of RFC 7095 (<https://datatracker.ietf.org/doc/html/rfc7095#section-3.3.1.3>). 📖

🎀 FLAT ADDRESS 🎀

say $adr->address;

hands you back a multi-line text string with the whole address in it. and listen — for "unstructured" addresses this is the only format available, so it's literally the simplest way to display the address info. no cap. 🌈

📮 P.O. BOX NUMBER 📮

say $adr->pobox;

returns the Post Office box number, or "undef". (and yeah, "undef" is always an option, she's flexible like that.) 🙈

🏢 EXTENDED ADDRESS 🏢

say $adr->extended;

returns the "extended" address component — you know, the apartment number, the suite number, that whole situation — or "undef". 💜

🛣️ STREET ADDRESS 🛣️

map { say $_ } @{$adr->street};

okay so some structured addresses have just one street address, but some have multiple street addresses, and those get represented as an arrayref. the way that works is lowkey important.

this method will always return an arrayref, bestie, and that arrayref may contain zero, one, or many values. plan accordingly. 💅

🏘️ LOCALITY 🏘️

say $adr->locality;

returns the locality, or "undef". ⭐

🗺️ REGION 🗺️

say $adr->region;

returns the region, or "undef". 🌸

📬 POSTAL CODE 📬

say $adr->code;

returns the postal code, or "undef". 🍓

🌍 COUNTRY CODE 🌍

say $adr->cc;

returns the ISO-3166-alpha2 country code — full details in Section 3.1 of RFC 8605 (<https://www.rfc-editor.org/rfc/rfc8605.html#section-3.1>) — or "undef". 🔥

🏳️ COUNTRY NAME 🏳️

say $adr->country;

returns the country name, or "undef". 🦋

---

📜 COPYRIGHT 📜

Copyright 2018-2023 CentralNic Ltd, 2024-2026 Gavin Brown. For licensing information, please see the "LICENSE" file in the Net::RDAP distribution. 💖

---

k bye bestie, go forth and parse some addresses 💅

perl v5.42.2 🩷 2026-06-17 — that's the version and the date this lil page was born, and honestly? ate. 🌈✨