Mail::Box::Tie(3pm)

💖 Mail::Box::Tie — bestie edition 💖

okay so this is Mail::Box::Tie, a lil Perl module (from the User Contributed Perl Documentation fam) that lets you access an existing message-folder as an array or a hash. yes. like. actually use it like one. slay.

---

✨ NAME ✨

Mail::Box::Tie — access an existing message-folder as an array or hash 🫶

---

🌸 INHERITANCE 🌸

Mail::Box::Tie is extended by:

• Mail::Box::Tie::ARRAY
• Mail::Box::Tie::HASH

so so so. it's the blueprint, the two ARRAY and HASH ones are the girlies doing the actual work 💅

---

🎀 SYNOPSIS 🎀

As an array:

tie my(@inbox), Mail::Box::Tie::ARRAY => $folder;
print $inbox[3];

or as hash:

tie my(%inbox), Mail::Box::Tie::HASH => $folder;
print $inbox{'<12379.124879@example.com>'};

not me just casually tie-ing a folder and then indexing it like it's nothing 😭 iconic behaviour honestly

---

🦋 DESCRIPTION 🦋

okay think about it. folders literally look like an array of messages. so why not just… access them as one?? 😌 like the vibe is right there.

OR — and hear me out — say the order doesn't matter to you but the message-ids do (because relations, obvs), then why not access them from a hash keyed on that message-id? 🍓

programs using one of these ties will look simpler than programs using the more traditional method calls. that's the whole tea. no cap.

---

👑 METHODS 👑

💜 Constructors

• $class->new($folder, $type) — bestie, do not call this method directly. ever. fr fr. you go through the tie interface instead. that's the way. 🫶

🌈 Attributes

• $obj->folder()
• $obj->type()

---

💀 DIAGNOSTICS 💀

• Error: no folder specified to tie to. — cast by new(). basically the module looked around like "where's the folder bestie??" and there wasn't one 🙈

---

⭐ SEE ALSO ⭐

This module is part of Mail-Box version 4.02, built on April 10, 2026.

Website: http://perl.overmeer.net/CPAN/ ✨

---

📜 LICENSE 📜

For contributors see file ChangeLog.

This software is copyright (c) 2001-2026 by Mark Overmeer. 👑

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🌈

---

and that's the whole page, periodt 💅 — this was perl v5.40.1, dated 2026-05-09, and it's the Mail::Box::Tie(3pm) manual page. drink water, tie responsibly, love u bye 🎀💖