Author image 歌代 和正 (Kaz Utashiro)
and 2 contributors

NAME

Text::VisualPrintf - printf family functions to handle Non-ASCII characters

SYNOPSIS

    use Text::VisualPrintf;
    Text::VisualPrintf::printf FORMAT, LIST
    Text::VisualPrintf::sprintf FORMAT, LIST

    use Text::VisualPrintf qw(vprintf vsprintf);
    vprintf FORMAT, LIST
    vsprintf FORMAT, LIST

VERSION

Version 3.02

DESCRIPTION

Text::VisualPrintf is a almost-printf-compatible library with a capability of handling multi-byte wide characters properly.

When the given string is truncated by the maximum precision, space character is padded if the wide character does not fit to the remained space.

FUNCTIONS

printf FORMAT, LIST
sprintf FORMAT, LIST
vprintf FORMAT, LIST
vsprintf FORMAT, LIST

Use just like perl's printf and sprintf functions except that printf does not take FILEHANDLE.

Take a look at an experimental Text::VisualPrintf::IO if you want to work with FILEHANDLE and printf.

IMPLEMENTATION NOTES

Strings in the LIST which contains wide-width character are replaced before formatting, and recovered after the process.

Unique replacement string contains combinations of two ASCII characters not found in the format string and all parameters. If two characters are not available, function behaves just like a standard one.

SEE ALSO

Text::VisualPrintf, Text::VisualPrintf::IO

https://github.com/kaz-utashiro/Text-VisualPrintf

AUTHOR

Kazumasa Utashiro

LICENSE

Copyright (C) 2011-2020 Kazumasa Utashiro.

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