Term::...ld::XS(3pm)

💖 Term::Choose::LineFold::XS (3pm) — the perl manual page, but make it cute 💖

okay bestie, listen — this is the Term::Choose::LineFold::XS page from the User Contributed Perl Documentation, and it's literally just the XS acceleration for Term-Choose-LineFold. short page, big energy. let's go 🦋

---

✨ VERSION ✨

Version 0.005 💅

---

🌸 DESCRIPTION 🌸

okay so first things first, when we say width in this context, we mean the number of occupied columns a character string takes up on a terminal with a monospaced font. like, how much horizontal room it's eating. that's the whole vibe. 📏

by default, ambiguous width characters are treated as half width. periodt.

but — and this is the plot twist — if the environment variable TC_AMBIGUOUS_WIDTH_IS_WIDE is set to a true value, then ambiguous width characters are treated as full width. it's giving "surprise, your columns just doubled." 👑

🐚 Perl version

requires Perl version 5.16.0 or greater. no ancient perls allowed, we have standards 💅

---

🎀 EXPORT 🎀

Nothing by default. as in, zero. nada. it's ✨mysterious✨ until you ask nicely:

use Term::Choose::LineFold::XS qw( print_columns );

---

🔥 FUNCTIONS 🔥

print_columns

Get the number of occupied columns of a character string on a terminal. that's it. that's the function. she does one thing and she ate. 🫶

the string you pass in is a decoded string, and it has to be free of control characters, non-characters, and surrogates. no sneaky little gremlins in there, bestie, we're not doing that today 🙈

$print_width = print_columns( $string );

---

👑 AUTHOR 👑

Matthäus Kiem <cuer2s@gmail.com> 💜

---

📜 LICENSE AND COPYRIGHT 📜

Copyright (C) 2025-2026 Matthäus Kiem.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For details, see the full text of the licenses in the file LICENSE.

---

ngl this page was short but she said everything she needed to say. no filler, all main character energy 🌈

okay bye bestie, this was perl v5.42.3, dated 2026-08-19, and it's still the User Contributed Perl Documentation edition of Term::Choose::LineFold::XS. slay 💖✨🎀