MAB2::...::Disk(3pm)

✨ MAB2::...::Disk — bestie's guide to the MAB2 Diskette parser ✨

okay so like, quick vibe check: this page is MAB2::...::Disk(3pm) from the User Contributed Perl Documentation, and the star of the show is MAB2::Parser::Disk — a parser for MAB2 Diskette records. yes ma'am, that's the whole assignment. 💅

---

🌸 NAME 🌸

MAB2::Parser::Disk — the MAB2 Diskette format parser. that's it, that's the name, iconic behavior honestly.

---

🦋 SYNOPSIS 🦋

so MAB2::Parser::Disk is a parser for MAB2 Diskette records. periodt.

IMPORTANT bestie: MAB2::Parser::Disk expects UTF-8 encoded files as input. otherwise, hand it a filehandle that already has a specified I/O layer. don't skip that part, she WILL notice. 😭

use MAB2::Parser::Disk;

my $parser = MAB2::Parser::Disk->new( $filename );

while ( my $record_hash = $parser->next() ) {
    # do something
}

---

🎀 Arguments 🎀

• file — the path to the file that's holding your MAB2 Diskette records. give her the address, she'll go get it. 🫶
• fh — an open filehandle for the file with MAB2 Diskette records. if you're bringing the filehandle yourself, that's your moment, main character energy. ✨

---

👑 METHODS 👑

🌈 new($filename | $filehandle)

this is how you birth the parser into existence, babes. pass it either a filename or a filehandle — your choice, both are valid, we love options here. 💖

🌈 next()

reads the next record from the MAB2 input stream and returns a Perl hash. literal chef's kiss. loop over it like the synopsis shows and you're golden. 🔥

🌈 _decode($record)

deserializes a raw MAB2 record into an ARRAY of ARRAYs. it's giving "unboxing but for data structures." lowkey obsessed. 📦✨

---

🔥 SEE ALSO 🔥

• Catmandu::Importer::MAB2 — go check her out too, iykyk. 💜

---

💖 AUTHOR 💖

Johann Rolschewski <jorol@cpan.org> — the legend who made this whole thing happen. bow down. 👑

---

🎀 COPYRIGHT AND LICENSE 🎀

this software is copyright (c) 2013 by Johann Rolschewski.

it's free software — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay, open source rights fr fr. 🦋

---

💀 no cap, remember the UTF-8 thing. UTF-8 files, or a filehandle with an I/O layer set. that's the whole plot twist.

---

okay and that's the tea, bestie — perl v5.36.0, dated 2022-12-04, straight from the User Contributed Perl Documentation. go parse something cute. 💅🌸💖