Zonema...DNSName(3pm)

✨ NAME ✨

Zonemaster::Engine::DNSName — a whole class that is literally just a glow-up for DNS names 💅 (it's a class representing DNS names, bestie, that's the whole vibe)

---

🦋 SYNOPSIS 🦋

my $name1 = Zonemaster::Name->new('www.example.org');
my $name2 = Zonemaster::Name->new('ns.example.org');
say "Yay!" if $name1->common($name2) == 2;

no cap, that's it, that's the whole thing 🫶

---

🎀 ATTRIBUTES 🎀

• labels — a reference to a list of strings, aka the actual labels your DNS name is built out of. like, the little pieces. the building blocks. the ✨ingredients✨.

---

💖 METHODS 💖

• new($input) or new({ labels => \@labellist }) — the constructor!! you can call it two ways: with one single argument, or with a reference to a hash (like in the example up there 👆).

okay so if you give it a single argument, it has to be one of these three things, no exceptions:

• a non-reference
• a Zonemaster::Engine::DNSName object
• a Zonemaster::Engine::Zone object

and here's what happens depending on what you handed it:

• if it's a non-reference → it gets split at period characters (possibly after stringification, iykyk) and the resulting list becomes the name's labels 🌈
• if it's a Zonemaster::Engine::DNSName object → it just gets returned as-is. she said "I'm already iconic, no changes needed" 💅
• if it's a Zonemaster::Engine::Zone object → the value of its "name" attribute gets returned ✨

• from_string($domain) — a specialized constructor, and she is picky: you must call her with a string. periodt. 🎀
• string() — returns a string representation of the name 💖 the string gets made by joining the labels with dots. and if there are no labels at all? you get a single dot back. just one. lonely little dot. 🫶

heads up: names created this way do not have a trailing dot!

oh and the stringification operator is overloaded to this function, so honestly you'll rarely ever need to call it directly. she just works ✨

• fqdn() — returns the name as a string, but this time complete with a trailing dot ⭐ that's the whole difference. fully qualified, fully dressed.
• str_cmp($other) — overloads string comparison 🔥 the comparison happens after converting both names to upper case, and it ignores any trailing dot on the other name. so like, chill about the dot, bestie.
• next_higher() — returns a brand new Zonemaster::Engine::DNSName object representing the name you called it on, but with the leftmost label removed. she's evolving 💅
• common($other) — returns the number of labels, counting from the rightmost going left, that are the same in both names. this gets used by the recursor to check for redirections going up the DNS tree 🌳 iconic behavior honestly
• is_in_bailiwick($other) — returns true if $other is in-bailiwick of $self, and false otherwise 👑

see also <https://tools.ietf.org/html/rfc7719#section-6> — go read it, she's serving lore 📖

• prepend($label) — returns a new Zonemaster::Engine::DNSName object representing the called one with the given label prepended. front of the line, no cutting 🎀
• TO_JSON — helper method for JSON encoding ✨ that's literally all she does and she does it flawlessly.

---

and that's the whole page, bestie!! no notes, she ate 💅✨

this was brought to you by the perl v5.40.1 girlies, dated 2026-03-21 — and yes, it was user contributed Perl documentation, so thank a real one 🫶💖 bye mwah 😘