Net::DNS::Mailbox(3)

💌 Net::DNS::Mailbox — bestie edition

okay so this is the Net::DNS::Mailbox(3) page from the User Contributed Perl Documentation collection, and honestly? it's giving "small module, big personality." come sit with me 🫶

✨ NAME ✨

Net::DNS::Mailbox — like, the DNS mailbox representation, that's the whole vibe 💅

🌸 SYNOPSIS 🌸

        use Net::DNS::Mailbox;

        $mailbox = Net::DNS::Mailbox->new('user@example.com');
        $address = $mailbox->address;

look at her go. iconic. no notes. ✨

🦋 DESCRIPTION 🦋

so the Net::DNS::Mailbox module implements a subclass of DNS domain name objects — and what she represents is the DNS coded form of an RFC822 mailbox address. that's it, that's the job 🎀

and there's lore here, bestie 👀 — the Net::DNS::Mailbox1035 and Net::DNS::Mailbox2535 packages implement mailbox representation subtypes that provide the name compression and canonicalisation specified by RFC1035 and RFC2535. those exist because of the backward compatibility requirements introduced by RFC3597. fr fr, it's a whole family tree. 🌈

---

💖 METHODS 💖

🍓 new

        $mailbox = Net::DNS::Mailbox->new('John Doe <john.doe@example.com>');
        $mailbox = Net::DNS::Mailbox->new('john.doe@example.com');
        $mailbox = Net::DNS::Mailbox->new('john\.doe.example.com');

Creates a mailbox object representing the RFC822 mail address specified by the character string argument. and yes, an encoded domain name is also accepted — that's for backward compatibility with Net::DNS 0.68 and earlier, so the old girlies still get to sit with us 🫶

the argument string consists of printable characters from the 7-bit ASCII repertoire. that's the whole dress code. 👑

⭐ address

        $address = $mailbox->address;

Returns a character string containing the RFC822 mailbox address corresponding to the encoded domain name representation described in RFC1035 section 8. so like… she decodes the thing and hands you the address back. slay. 💅

---

👑 COPYRIGHT 👑

Copyright (c)2009,2012 Dick Franks.

All rights reserved. periodt. 💜

🧚 LICENSE 🧚

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the original copyright notices appear in all copies and that both copyright notice and this permission notice appear in supporting documentation, and that the name of the author not be used in advertising or publicity pertaining to distribution of the software without specific prior written permission.

okay this next part is the all-caps legal moment, and we respect her 🫡 — THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

🌈 SEE ALSO 🌈

• perl
• Net::DNS
• Net::DNS::DomainName
• RFC1035 <https://iana.org/go/rfc1035>
• RFC5322 <https://iana.org/go/rfc5322>

go read them, iykyk 📚✨

---

okay that's the whole page!! 🎀 cute little sign-off: this is perl v5.42.0, dated 2026-09-02, and we're living in Net::DNS::Mailbox(3) era. mwah. 💋💖