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

   print_columns
       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.

perl v5.40.1                                       2025-06-09                    Term::Choose::LineFold::XS(3pm)