/ 
MIME-EcoEncode-0.95
River stage one • 1 direct dependent • 4 total dependents
/ MIME::EcoEncode::Fold

NAME

MIME::EcoEncode::Fold - folding multi-byte string

SYNOPSIS

use MIME::EcoEncode::Fold;
$folded = mime_eco_fold($str, 'UTF-8');        # fold utf8 string
$folded = mime_eco_fold($str, 'GB2312');       # fold euc-cn string
$folded = mime_eco_fold($str, 'EUC-KR');       # fold euc-kr string
$folded = mime_eco_fold($str, 'Big5');         # fold big5 string
$folded = mime_eco_fold($str, 'Shift_JIS');    # fold cp932 string
$folded = mime_eco_fold($str, 'ISO-2022-JP');  # fold 7bit-jis string
$folded = mime_eco_fold($str, $sbcs);          # $sbcs :
                                               #   single-byte charset
                                               #   (e.g. 'ISO-8859-1')

DESCRIPTION

This is a module for folding multi-byte string.

When the line of the e-mail text is long, SMTP server may insert line feed code and the multi-byte string might break. This module was written in order to prevent it.

Options

$folded = mime_eco_fold($str, $charset, $lf, $bpl);
             # $charset : 'UTF-8' / 'GB2312' / 'EUC-KR' / 'Big5' /
             #            'Shift_JIS' / 'ISO-2022-JP' / ...
             #            (default: 'UTF-8')
             #              Note: The others are all folded as
             #                    single-byte string.
             # $lf      : line feed (default: "\n ")
             # $bpl     : bytes per line (default: 990)
             #              Note: 990 is postfix's default.

Examples

Ex1

use MIME::EcoEncode::Fold;
my $str =<<"END";
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements.
END
print mime_eco_fold($str, 'UTF-8', undef, 50);

Ex1's output:

This document specifies an Internet standards trac
 k protocol for the
Internet community, and requests discussion and su
 ggestions for
improvements.

SEE ALSO

MIME::EcoEncode

AUTHOR

MURATA Yasuhisa <murata@nips.ac.jp>

COPYRIGHT

Copyright (C) 2013 MURATA Yasuhisa

LICENSE

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