summaryrefslogtreecommitdiff
path: root/fml/lib/Mail/Message/Encode.pm
blob: 8544c9b125c1ce0520ec24e37db8496a4f19fc07 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
#-*- perl -*-
#
#  Copyright (C) 2001,2002 Ken'ichi Fukamachi
#   All rights reserved. This program is free software; you can
#   redistribute it and/or modify it under the same terms as Perl itself.
#
# $FML: Encode.pm,v 1.2 2002/05/23 12:47:51 fukachan Exp $
#

package Mail::Message::Encode;
use strict;
use vars qw(@ISA @EXPORT @EXPORT_OK);
use Carp;


=head1 NAME

Mail::Message::Encode - MIME encoding engine

=head1 SYNOPSIS

    use Mail::Message::Encode qw(encode_mime_string);
    $encoded = encode_mime_string( $message );

=head1 DESCRIPTION

MIME utilities to encode the specified string $message.  It uses C<IM>
modlues as encoding engines.

=head1 METHODS

=cut


require Exporter;
@ISA       = qw(Exporter);
@EXPORT_OK = qw(encode_mime_string);


=head2 C<encode_mime_string(string, [$options])>

encode the C<string> by the encoder $options->{ encode }.
The encode is base64 by default.

C<options> is a HASH REFERENCE.
You can specify the charset of string to return
by $options->{ charset }.

=cut


# Descriptions: encode string
#    Arguments: STR($str) HASH_REF($option)
# Side Effects: none
# Return Value: STR
sub encode_mime_string
{
    my ($str, $options) = @_;
    my $charset = (defined $options->{ 'charset' } ?
		   $options->{ 'charset' } :
		   'iso-2022-jp');
    my $encode  = (defined $options->{ 'encode' } ?
		   $options->{ 'encode' } :
		   'base64');
    my $header  = '=?'. $charset;
    my $trailor = '?=';

    use Jcode;
    &Jcode::convert(\$str, 'jis');

    use IM::Iso2022jp;

    if ($encode eq 'base64') {
	line_iso2022jp_mimefy($str);
    }
    elsif ($encode eq 'qp') {
	$main::HdrQEncoding = 1;
	line_iso2022jp_mimefy($str);
	$main::HdrQEncoding = 0;
    }

    return $str;
}


=head1 SEE ALSO

L<Jcode>,
L<IM::Iso2022jp>.

=head1 AUTHOR

Ken'ichi Fukamachi

=head1 COPYRIGHT

Copyright (C) 2001,2002 Ken'ichi Fukamachi

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

=head1 HISTORY

Mail::Message::Encode appeared in fml5 mailing list driver package.
See C<http://www.fml.org/> for more details.

=cut


1;