WrapI18N(3)

📦
version 0.06 · 10 versions
, in opensuse-leap 16.0

💖 WrapI18N(3) — Text::WrapI18N is the line-wrapping bestie 💖

Okay so: this is a User Contributed Perl Documentation page, section 3, for Text::WrapI18N. She wraps lines, she gets multibyte, and she's here to make your terminal text look iconic instead of cursed. 🫶✨

✨ NAME ✨

Text::WrapI18N — a line wrapping module with support for multibyte, fullwidth, and combining characters, plus languages without whitespaces between words. No cap, that's the whole vibe check. 💅

🌸 SYNOPSIS 🌸

  use Text::WrapI18N qw(wrap $columns);
  wrap(firstheader, nextheader, texts);

🦋 DESCRIPTION 🦋

Okay bestie, this module is lowkey aiming to be a better Text::Wrap module. You need her for multibyte character encodings such as UTF-8, EUC-JP, EUC-KR, GB2312, and Big5. She also supports characters with irregular widths — yes, we're talking about combining characters (which occupy zero columns on terminal, like diacritical marks in UTF-8) and fullwidth characters (which occupy two columns on terminal, like most of east Asian characters). Also, minimal handling of languages which doesn't use whitespaces between words (like Chinese and Japanese) is supported. She's doing the most, respectfully. 😭👑

Quick reality check: like Text::Wrap, hyphenation and "kinsoku" processing are not supported, to keep simplicity. So don't come for her about that. 💀

wrap(firstheader, nextheader, texts) is the main subroutine of the Text::WrapI18N module, and she's the one who executes the line wrapping. Input parameters and output data emulate Text::Wrap. The texts have to be written in locale encoding. Periodt. 🎀

⭐ SEE ALSO ⭐

💜 AUTHOR 💜

Tomohiro KUBOTA, <kubota@debian.org> — literal icon, go say hi. 👑

Copyright 2003 by Tomohiro KUBOTA

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

Mwah 💋 — cute sign-off time: the footer says perl v5.42.0, dated 2012-02-01, and this page is WrapI18N(3). Bye bestie, go wrap something gorgeous! 💖🦋

📦 where this page comes from