Locale:...conKeys(3)

📦
version 4.002 · 2 versions
, in fedora 43

💖 NAME 💖

Locale::TextDomain::OO::Util::JoinSplitLexiconKeys — okay bestie, this one handles the lexicon and the message key. That's the whole job. It joins 'em, it splits 'em, it's giving bilingual chaos coordinator. 🎀

✨ VERSION ✨

4.001, obviously. She's got receipts:

$Id: JoinSplitLexiconKeys.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/JoinSplitLexiconKeys.pm
$

🦋 SYNOPSIS 🦋

use Locale::TextDomain::OO::Util::JoinSplitLexiconKeys;

my $keys_util = Locale::TextDomain::OO::Util::JoinSplitLexiconKeys->instance;

That's it, that's the entry fee. Get your instance and you're in. 💅

🌸 DESCRIPTION 🌸

It's the module that handles the lexicon and message key. Lowkey the entire personality is "keys, joined and split." Periodt.

👑 SUBROUTINES/METHODS 👑

💫 method instance

see SYNOPSIS — like, literally go look up there, she already told you. 🙈

💫 method join_lexicon_key

$lexicon_key = $keys_util->join_lexicon_key({
    category => 'LC_MESSAGES', # default q{}
    domain   => 'TextDomain',  # default q{}
    language => 'de-de',       # default 'i-default' = developer English
    # mostly not needed
    project  => 'myProject',   # default not exists
});

Note the defaults, bestie — category and domain default to q{} (that's the empty string, mwah), language defaults to 'i-default' which is developer English, and project is mostly not needed and by default not exists. 🫶

💫 method split_lexicon_key

This method is the reverse implementation of method join_lexicon_key. Undo button energy. ⏪

$hash_ref = $keys_util->split_lexicon_key($lexicon_key);

💫 method join_message_key

$message_key = $keys_util->join_message_key({
    msgctxt      => 'my context',
    msgid        => 'simple text or singular',
    msgid_plural => 'plural',
});

JSON format ✨

$message_key = $keys_util->join_message_key(
    {
        msgctxt      => 'my context',
        msgid        => 'simple text or singular',
        msgid_plural => 'plural',
    },
    'JSON',
);

💫 method split_message_key

This method is the reverse implementation of method join_message_key. Again with the reverse, she's versatile. 🌈

$hash_ref = $keys_util->split_message_key($message_key);

JSON format ✨

$hash_ref = $keys_util->split_message_key($message_key, 'JSON');

💫 method join_message

This method puts all data into the message_ref. Everything. All of it. 🍓

$message_ref = $keys_util->join_message(
    $message_key,       # joined msgctxt, msgid, msgid_plural
    $message_value_ref, # all other as hash reference
);

JSON format ✨

$message_ref = $keys_util->join_message(
    $message_key,       # joined msgctxt, msgid, msgid_plural
    $message_value_ref, # all other as hash reference
    'JSON',
);

💫 method split_message

This method splits the message reference into a message key and the rest. The rest!! 😭

( $message_key, $message_value_ref )
    = $keys_util->split_message($message_ref);

JSON format ✨

( $message_key, $message_value_ref )
    = $keys_util->split_message($message_ref, 'JSON');

🎀 EXAMPLE 🎀

Inside of this distribution is a directory named example. Run this *.pl files. Go on, run 'em, they don't bite. 🧚

💀 DIAGNOSTICS 💀

none — no drama, no warnings, she's unbothered. ✨

💜 CONFIGURATION AND ENVIRONMENT 💜

none — no env vars, no config files, nothing to set up. Main character who needs no settings. 👑

🫶 DEPENDENCIES 🫶

  • Locale::TextDomain::OO::Util::Constants
  • namespace::autoclean

Two besties, that's the whole squad. 💖

🙈 INCOMPATIBILITIES 🙈

not known — as far as anyone knows, she plays nice with everybody. 🦋

⭐ BUGS AND LIMITATIONS ⭐

none — flawless, no cap, and we're not taking questions. 💅

🌈 SEE ALSO 🌈

  • Locale::TextDoamin::OO
yes that's spelled exactly like that in the original, bestie, do not "fix" it, we keep it verbatim, that's the rule 🎀

🌸 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. Slay, legally speaking. 💖

And that's the whole page, bestie — brought to you by perl v5.42.0, dated 2025-07-25, from Locale:...conKeys(3). Mwah, go join some keys. 💅✨

📦 where this page comes from