[![Actions Status](https://github.com/kaz-utashiro/Text-ANSI-Fold-Util/workflows/test/badge.svg)](https://github.com/kaz-utashiro/Text-ANSI-Fold-Util/actions) [![MetaCPAN Release](https://badge.fury.io/pl/Text-ANSI-Fold-Util.svg)](https://metacpan.org/release/Text-ANSI-Fold-Util) # NAME Text::ANSI::Fold::Util - Text::ANSI::Fold utilities (width, substr) # SYNOPSIS use Text::ANSI::Fold::Util qw(:all); use Text::ANSI::Fold::Util qw(ansi_width ansi_substr); ansi_width($text); ansi_substr($text, $offset, $width [, $replacement]); use Text::ANSI::Fold::Util; Text::ANSI::Fold::Util::width($text); Text::ANSI::Fold::Util::substr($text, ...); # ansi_expand() was moved to Text::ANSI::Tabs ansi_expand($text); Text::ANSI::Fold::Util::expand($text); # VERSION Version 0.07 # DESCRIPTION This is a collection of utilities using Text::ANSI::Fold module. All functions are aware of ANSI terminal sequence. # FUNCTION There are exportable functions start with **ansi\_** prefix, and unexportable functions without them. - **width**(_text_) - **ansi\_width**(_text_) Returns visual width of given text. - **substr**(_text_, _offset_, _width_ \[, _replacement_\]) - **ansi\_substr**(_text_, _offset_, _width_ \[, _replacement_\]) Returns substring just like Perl's **substr** function, but string position is calculated by the visible width on the screen instead of number of characters. If an optional _replacement_ parameter is given, replace the substring by the replacement and return the entire string. It does not cut the text in the middle of multi-byte character, of course. Its behavior depends on the implementation of lower module. - **expand**(_text_, ...) - **ansi\_expand**(_text_, ...) This function is now moved to [Text::ANSI::Tabs](https://metacpan.org/pod/Text%3A%3AANSI%3A%3ATabs) module. Interface remains only for backward compatibility, and may be deprecated in the future. # SEE ALSO [Text::ANSI::Fold::Util](https://metacpan.org/pod/Text%3A%3AANSI%3A%3AFold%3A%3AUtil), [https://github.com/kaz-utashiro/Text-ANSI-Fold-Util](https://github.com/kaz-utashiro/Text-ANSI-Fold-Util) [Text::ANSI::Fold::Tabs](https://metacpan.org/pod/Text%3A%3AANSI%3A%3AFold%3A%3ATabs), [https://github.com/kaz-utashiro/Text-ANSI-Fold-Tabs](https://github.com/kaz-utashiro/Text-ANSI-Fold-Tabs) [Text::ANSI::Fold](https://metacpan.org/pod/Text%3A%3AANSI%3A%3AFold), [https://github.com/kaz-utashiro/Text-ANSI-Fold](https://github.com/kaz-utashiro/Text-ANSI-Fold) [Text::Tabs](https://metacpan.org/pod/Text%3A%3ATabs) # LICENSE Copyright 2020-2021 Kazumasa Utashiro. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. # AUTHOR Kazumasa Utashiro