MIME::P...:Reader(3)

💖 MIME::Parser::Reader 💖

okay bestie so the manual page header is literally out here saying MIME::P...:Reader(3) — yeah, truncated mid-word, the header is giving mysterious ✨ — but the actual module is MIME::Parser::Reader, a line-oriented reader for a MIME::Parser, page 3 of the manual, from the User Contributed Perl Documentation. sit down, hydrate, let's get into it 🫶

---

✨ NAME ✨

MIME::Parser::Reader — it's a line-oriented reader for a MIME::Parser. that's the whole name, that's the whole job 💅

---

🌸 SYNOPSIS 🌸

so this module is used internally by MIME::Parser. you probably don't need to be looking at it at all, fr fr. but just in case… here's the vibe:

### Create a top-level reader, where chunks end at EOF:
$rdr = MIME::Parser::Reader->new();

### Spawn a child reader, where chunks also end at a boundary:
$subrdr = $rdr->spawn->add_boundary($bound);

### Spawn a child reader, where chunks also end at a given string:
$subrdr = $rdr->spawn->add_terminator($string);

### Read until boundary or terminator:
$subrdr->read_chunk($in, $out);

look at those comments, they're literally the map 🗺️ new reader = top-level, chunks end at EOF. spawn a child = chunks also end at a boundary. spawn another child = chunks also end at a given string. then you read_chunk until boundary or terminator and you're done. iconic, no notes 🔥

---

🦋 DESCRIPTION 🦋

it's a line-oriented reader that can deal with a virtual end-of-stream, where that end-of-stream is defined by a whole collection of boundaries. that's the whole thing. it's a reader that doesn't need the stream to actually end, because the boundaries are out here doing the ending for it 😌

⚠️ Warning: this is a private class solely for use by MIME::Parser. This class has no official public interface. not a single one. it's giving "backstage pass only, no public entrance" 💀

---

🌈 SEE ALSO 🌈

• MIME::Tools
• MIME::Parser

go read those if you actually want the plot, this one's just the side character that ate 💖

---

and that's the whole page, bestie 🎀 written by the fine folks of User Contributed Perl Documentation, perl v5.42.0, dated 2026-02-11 — mwah, stay slaying 💅✨