NAME

Term::Choose::LineFold::XS - XS acceleration for Term-Choose-LineFold

VERSION

Version 0.001

DESCRIPTION

Width in this context refers to the number of occupied columns of a character string on a terminal with a monospaced font.

By default ambiguous width characters are treated as half width. If the environment variable TC_AMBIGUOUS_WIDTH_IS_WIDE is set to a true value, ambiguous width characters are treated as full width.

Perl version

Requires Perl version 5.16.0 or greater.

EXPORT

Nothing by default.

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

FUNCTIONS

Get the number of occupied columns of a character string on a terminal.

The string passed to this function is a decoded string, free of control characters, non-characters, and surrogates.

$print_width = print_columns( $string );

AUTHOR

Matthäus Kiem <cuer2s@gmail.com>

LICENSE AND COPYRIGHT

Copyright (C) 2025 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.