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

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.

VARIABLES

$VISUAL_WIDTH

Hold a function pointer to calculate visual width of given string. Default function is Text::VisualWidth::PP::width.

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

Text::ANSI::Printf

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.