Log::R...ompact(3pm)

💖 NAME 💖

Log::Report::Lexicon::MOTcompact — bestie, it's the module that pulls your translations straight out of an MO file. 💅

---

🌸 INHERITANCE 🌸

Log::Report::Lexicon::MOTcompact is a Log::Report::Lexicon::Table

(so yeah, it's got the whole Table family tree going on ✨)

---

🦋 SYNOPSIS 🦋

# using a MO table efficiently
my $mot = Log::Report::Lexicon::MOTcompact->read('mo/nl.mo')
   or die;

my $header = $mot->msgid('');
print $mot->msgstr($msgid, 3);

---

✨ DESCRIPTION ✨

Okay so this module does the translating, and it's built on MO files — those are the binary versions of PO files, aka the "Machine Object" format. 📦

Lowkey tea though: this module isn't actually "compact" anymore. It's not out here trading off speed for memory. And ngl, that could totally change again in the future. 🙈

To get a MO file you first need a PO file, and then you run msgfmt, which is part of the gnu gettext package. 🎀

msgfmt -cv -o $domain.mo $domain.po

# -c = --check-format & --check-header & --check-domain
# -v = --verbose
# -o = --output-file

Extends "DESCRIPTION" in Log::Report::Lexicon::Table. 🫶

---

💜 METHODS 💜

Extends "METHODS" in Log::Report::Lexicon::Table.

---

🎀 Constructors 🎀

Extends "Constructors" in Log::Report::Lexicon::Table.

• $class->new(%options) — inherited, so go read "Constructors" in Log::Report::Lexicon::Table. 💖
• $class->read($filename, %options) — reads all the MOT table info out of $filename. 📖

Here's the option sitch:

-Option --Default charset <from header>

• charset => STRING — the character-set this file is using. If you don't say anything, it gets pulled from the "Content-Type" field in the PO-file. slay ✨

---

🌈 Attributes 🌈

Extends "Attributes" in Log::Report::Lexicon::Table.

• $obj->filename() — returns the name of the source file for this data. 🗂️
• $obj->index() — returns a HASH of all defined PO objects, organized by msgid. But bestie, please try to avoid using this — use msgid() for lookup instead, fr fr. 🙏
• $obj->originalCharset() — returns the character-set as found in the PO-file. The strings get converted into utf8 before you use them in the program. 🦋

---

💅 Managing PO's 💅

Extends "Managing PO's" in Log::Report::Lexicon::Table.

⭐ Translation ⭐

Extends "Translation" in Log::Report::Lexicon::Table.

• $obj->msgid( STRING, [$msgctxt] ) — looks up the translations with the "STRING". Returns a SCALAR when there's only one translation known, and an ARRAY when we've got plural forms. Returns "undef" when the translation isn't defined. Improves base, see "Translation" in Log::Report::Lexicon::Table. 👑
• $obj->msgstr( $msgid, [$count, $msgctxt] ) — returns the translated string for $msgid. If you don't specify it, $count is 1 (the singular form). Improves base, see "Translation" in Log::Report::Lexicon::Table. 🌸

🧚 Administration 🧚

Extends "Administration" in Log::Report::Lexicon::Table.

• $obj->add($po) — inherited, see "Administration" in Log::Report::Lexicon::Table. 💜
• $obj->header($field) — inherited, see "Administration" in Log::Report::Lexicon::Table. 💜
• $obj->nrPlurals() — inherited, see "Administration" in Log::Report::Lexicon::Table. 💜
• $obj->pluralIndex($count) — inherited, see "Administration" in Log::Report::Lexicon::Table. 💜
• $obj->setupPluralAlgorithm() — inherited, see "Administration" in Log::Report::Lexicon::Table. 💜
• $obj->translations( [$active] ) — inherited, see "Administration" in Log::Report::Lexicon::Table. 💜

---

😭 DIAGNOSTICS 😭

the way these all just say "Cast by" — that's the module throwing hands when something goes wrong 💀

• Error: cannot detect charset in $fn Cast by read()
• Fault: cannot read magic from $fn: $! Cast by read()
• Fault: cannot read mo from file $fn: $! Cast by read()
• Fault: cannot read msgids from $fn, need $size at $loc: $! Cast by read()
• Fault: cannot read originals from $fn, need $size at $loc: $! Cast by read()
• Fault: cannot read superblock from $fn: $! Cast by read()
• Fault: cannot read translations from $fn, need $size at $loc: $! Cast by read()
• Fault: cannot read translations from $fn, need $size at $loc: $! Cast by read()
• Fault: cannot seek to $loc in $fn for msgid strings: $! Cast by read()
• Fault: cannot seek to $loc in $fn for originals: $! Cast by read()
• Fault: cannot seek to $loc in $fn for transl strings: $! Cast by read()
• Fault: cannot seek to $loc in $fn for translations: $! Cast by read()
• Error: invalid plural-form algorithm '$alg' Cast by setupPluralAlgorithm()
• Error: only acceptable parameter is 'ACTIVE' Cast by translations()
• Error: the header is not the first entry, needed for charset in $fn Cast by read()
• Error: there is no Plural-Forms field in the header, but needed Cast by pluralIndex()
• Error: unsupported charset $charset in $fn Cast by read()
• Error: unsupported explicit charset $charset for $fn Cast by read()
• Error: unsupported file type (magic number is $magic) Cast by read()

---

👑 SEE ALSO 👑

This module is part of Log-Report-Lexicon version 1.15, built on November 06, 2025. Website: http://perl.overmeer.net/CPAN/ 🌐

---

📜 LICENSE 📜

For contributors see file ChangeLog.

This software is copyright (c) 2007-2025 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 a wrap bestie 🫶 this page came from perl v5.40.1, dated 2025-11-11 — no cap, go forth and translate ✨💅