Juman::Encode(3pm)

✨ Juman::Encode(3pm) ✨

bestie. sit down. we're talking about Juman::Encode, a lil Perl module that does character encoding functions, and it lives in the User Contributed Perl Documentation section (section 3pm, iykyk). 💖

---

🌸 NAME 🌸

Juman::Encode — character encoding functions, that's it, that's the job 🫶

---

🦋 DESCRIPTION 🦋

okay so here's the tea. Perl-5.8.x uses Unicode as its internal character encoding. periodt. but that means whenever you're doing input/output with a process that's using Japanese EUC, or whenever you're reading data that was written in Japanese EUC, you always have to explicitly encode/decode. no shortcuts, no vibes-based guessing. 💅

and that's literally why this library exists — it defines the functions for exactly that. 💖

---

🎀 FUNCTIONS 🎀

• $octets = encode ( $string ) — encodes a string using the character encoding specified by the "encoding" pragma, and you get back a byte string. boom. ✨
• $string = decode ( $octets ) — decodes a byte string using the character encoding specified by the "encoding" pragma, and you get back a string. iconic. 🌈
• set_encoding ( $handle ) — sets things up so that communication with the given file handle uses the character encoding specified by the "encoding" pragma. 🦋

and listen — all of these functions do absolutely nothing if the "encoding" pragma isn't specified. like, they just stand there. slay, but also, noted. 💀

---

👑 MEMO 👑

so why does this library even exist as its own thing? because the definitions of the functions that need to look at the variable ${^ENCODING} got gathered into one single place. and the reason for that is very much giving "protect the children": code that tries to reference the variable ${^ENCODING} turns into a syntax error on Jperl-5.005. no cap. 😭

Sample Script:

use English qw/ $PERL_VERSION /;
if( $PERL_VERSION > 5.008 ){
    ${^ENCODING}->encode( ... );
}

Error Message:

syntax error at sample.perl line 3, near "{^"

see? told you. 💀

---

🌟 SEE ALSO 🌟

• encoding
• Encode

---

💜 AUTHOR 💜

土屋 雅稔 <tsuchiya@pine.kuee.kyoto-u.ac.jp> — the main character who wrote this, we stan 🫶

---

🙈 POD ERRORS 🙈

hey!! bestie!! the document above had some coding errors, and here's the explanation, bestie:

Around line 14:

Non-ASCII character seen before =encoding in 'は内部文字コードとして'. Assuming UTF-8

Around line 108:

=over without closing =back

(pod just doing pod things, we forgive it 🎀)

---

and that's the whole page, bestie!! this lil rewrite is chillin' under perl v5.40.1, dated 2026-02-11, and yes it's still Juman::Encode(3pm) at the end of the day 💖✨ bye ily, go encode responsibly 🦋