Locale:...ctHeader(3)

📦
version 4.002 · 2 versions
, in fedora 43

💖 Locale::TextDomain::OO::Util::ExtractHeader — bestie edition 💖

okay so picture this: you're deep in the User Contributed Perl Documentation section of the manual (iykyk), and you've found the one, the only, the header extractor. Locale::TextDomain::OO::Util::ExtractHeader is here to pull the good stuff out of your gettext header. slay. 🎀

✨ VERSION ✨

4.001
$Id: ExtractHeader.pm 715 2018-06-04 15:08:31Z steffenw $
$HeadURL:
svn:ssh://steffenw@svn.code.sf.net/p/perl-gettext-oo/code/Locale-TextDomain-OO-Util/trunk/lib/Locale/TextDomain/OO/Util/ExtractHeader.pm
$
wait — the $HeadURL above is literally what the page says, so don't @ me about the svn:ssh: vs svn+ssh: thing, I'm just the messenger 💀. Actually, hmm, let me give you the exact line as it appears, no editing, no cap:
$HeadURL:
svn+ssh://steffenw@svn.code.sf.net/p/perl-gettext-oo/code/Locale-TextDomain-OO-Util/trunk/lib/Locale/TextDomain/OO/Util/ExtractHeader.pm
$

periodt. 💅

🌸 SYNOPSIS 🌸

use Locale::TextDomain::OO::Util::ExtractHeader;

my $extractor = Locale::TextDomain::OO::Util::ExtractHeader->instance;

that's it. that's the whole vibe. you use it, you grab the instance, and you're off. ✨

🦋 DESCRIPTION 🦋

This module is extracts charset and plural date from gettext header.

(yes bestie, "is extracts" — the module is that confident, and honestly? iconic. it does not care about grammar, it cares about headers.) 💖

👑 SUBROUTINES/METHODS 👑

🎀 method instance

See SYNOPSIS. This method returns a value you can call "extract_header_msgstr" on.

so like, instance hands you back a thing, and that thing is the thing you call extract_header_msgstr on. the pipeline is piping. 🫶

🎀 method extract_header_msgstr

$hash_ref = $extractor->extract_header_msgstr($header_msgstr);

That hash_ref contains:

nplurals      => $count_of_plural_forms,
plural        => $the_original_formula,
plural_code   => $code_ref__to_select_the_right_plural_form,
charset       => $charset,
lexicon_class => 'from X-Lexicon-Class',

look at all those keys. five of them. every single one accounted for. no keys left behind. 💜

🌈 EXAMPLE 🌈

See the *.pl files in the example directory in this distribution.

⭐ DIAGNOSTICS ⭐

confess

(it confesses. dramatic. we love a transparent king.) 🙈

💅 CONFIGURATION AND ENVIRONMENT 💅

none

🍓 DEPENDENCIES 🍓

  • Carp
  • English
  • namespace::autoclean

three little dependencies, all in a row, cute. 🧚

💀 INCOMPATIBILITIES 💀

not known

😭 BUGS AND LIMITATIONS 😭

none

literally zero bugs, we're thriving, no notes. 🔥

👀 SEE ALSO 👀

  • Locale::TextDomain::OO

go check out the main character of the family. 🏠

🫶 AUTHOR 🫶

Steffen Winkler

Copyright (c) 2014 - 2018, Steffen Winkler "<steffenw at cpan.org>". All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

ngl the "same terms as Perl itself" line is the free-software equivalent of "we're all in this together". bestie behaviour fr fr. 🌸

✨ cute lil sign-off ✨

okay so this whole thing? it's perl v5.42.0, dated 2025-07-25, and it lives in Locale:...ctHeader(3). that's the tea, that's the whole page, and you ate. go forth and extract those headers, bestie. mwah. 💅💖🌈

📦 where this page comes from