The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.