Net::RDAP::Link(3)

πŸ“¦
version 0.43 Β· 3 versions
, in fedora 44

okay bestie, so this is Net::RDAP::Link β€” part of the Net::RDAP distribution, and yes it's the Perl doc page for it, welcome to the group chat ✨


✨ NAME ✨

Net::RDAP::Link β€” a module representing an RDAP link. that's it, that's the whole job, and it does it beautifully πŸŽ€


🌸 DESCRIPTION 🌸

Links are literally everywhere in RDAP. like, everywhere. The following objects can contain zero or more links:

  • objects (peep Net::RDAP::Object)
  • remarks (peep Net::RDAP::Remark)
  • notices (peep Net::RDAP::Notice)
  • events (peep Net::RDAP::Event)

And in all of those cases, the modules representing those object types inherit from Net::RDAP::Base, which means they all hand you a links() method that returns a (maybe empty, no big deal) array of Net::RDAP::Link objects. consistency? we love her πŸ’…


πŸ‘‘ METHODS πŸ‘‘

πŸ’œ Value

$value = $link->value;

Gives you back a string holding the value of the value property of the link object β€” if there is one. no value? no string. simple as that πŸ¦‹

πŸ’œ Context URI

$uri = $link->context;

Returns a URI object for the context URI of the link, exactly as described in Section 3.2 of RFC 8288 <https://datatracker.ietf.org/doc/html/rfc8288#autoid-13>. πŸ“Ž

This URI object gets constructed from the value of the value property (the one we just talked about, keep up bestie 😌). And here's the cute part: if that property's value is a relative URL, then an absolute URL gets computed for you, using the URI of the RDAP response that contains the link object. math-ing it out for you, iconic behaviour fr fr ✨

πŸ’œ Relationship

$rel = $link->rel;

Returns the relationship attribute. The possible values are defined by an IANA registry, so go check the source of truth:

πŸ’œ URL

$url = $link->href;

Returns a URI object corresponding to the target of the link. where's it pointing? now you know πŸ”₯

πŸ’œ Language

@languages = $link->hreflang;

Returns a (potentially empty!) array containing the ISO-639-2 codes describing the language(s) the target is available in. multilingual queen 🌈

πŸ’œ Title

$title = $link->title;

Returns the title attribute of the link. What's it for? It labels the destination of a link so it can be used as a human-readable identifier β€” in the language of the context where the link shows up. so thoughtful πŸ₯Ί

πŸ’œ Media

$media = $link->media;

Returns the media attribute of the link. This one corresponds to the media/device that the target resource is optimized for. phone? printer? screen? she knows πŸ’…

πŸ’œ Media Type

$type = $link->type;

Returns a MIME::Type object corresponding to the media type of the target resource.

$is = $link->is_rdap;

And this one returns true if the media type of the target resource suggests that it's an RDAP resource. vibe check passed βœ…


Copyright 2018-2023 CentralNic Ltd, 2024-2026 Gavin Brown. For licensing information, please see the LICENSE file in the Net::RDAP distribution. (yes bestie, read the license, it's giving responsible πŸ’–)


okay that's the whole page, mwah 🫢 this was Net::RDAP::Link, documented in the User Contributed Perl Documentation section of the manual, and this version is from perl v5.42.2, dated 2026-06-17. go forth and parse those links, you absolute main character πŸ‘‘βœ¨

πŸ“¦ where this page comes from