Mail::Message::TransferEnc::Base64(3pm)

1Mail::Message::TransferUEsnecr::CBoanster6i4b(u3t)ed PerMlaiDlo:c:uMmeesnstaagtei:o:nTransferEnc::Base64(3)
2
3
4

NAME

6       Mail::Message::TransferEnc::Base64 - encode/decode base64 message bod‐
7       ies
8

INHERITANCE

10        Mail::Message::TransferEnc::Base64
11          is a Mail::Message::TransferEnc
12          is a Mail::Reporter
13

SYNOPSIS

15        my Mail::Message $msg = ...;
16        my $decoded = $msg->decoded;
17        my $encoded = $msg->encode(transfer => 'base64');
18

DESCRIPTION

20       Encode or decode message bodies with base64.  The e-mail protocol and
21       user agents can not handle binary data.  Therefore, binary data -but
22       even sometimes non-binary data- is encoded into ASCII, this is trans‐
23       portable.
24
25       Base64 re-groups the bits of bytes, and maps them on characters. The
26       data contains bytes of 8 bits (an octet).  These are repacked into
27       groups of 6 bits, pointing in an array of characters containing
28       "[A-Za-z0-9+/]".  This way, three data bytes become 4 base64 bytes.
29       The encoded data will be trailed by '=' characters to align on four
30       bytes.
31

METHODS

33       Constructors
34
35       Mail::Message::TransferEnc::Base64->new(OPTIONS)
36
37           See "Constructors" in Mail::Reporter
38
39       The Encoder
40
41       Mail::Message::TransferEnc::Base64->addTransferEncoder(TYPE, CLASS)
42
43           See "The Encoder" in Mail::Message::TransferEnc
44
45       $obj->create(TYPE, OPTIONS)
46
47           See "The Encoder" in Mail::Message::TransferEnc
48
49       $obj->name
50
51           See "The Encoder" in Mail::Message::TransferEnc
52
53       Encoding
54
55       $obj->check(BODY, OPTIONS)
56
57           See "Encoding" in Mail::Message::TransferEnc
58
59       $obj->decode(BODY, OPTIONS)
60
61        Option     --Defined in                --Default
62        result_type  Mail::Message::TransferEnc  <type of source body>
63
64           . result_type CLASS
65
66       $obj->encode(BODY, OPTIONS)
67
68           See "Encoding" in Mail::Message::TransferEnc
69
70       Error handling
71
72       $obj->AUTOLOAD
73
74           See "Error handling" in Mail::Reporter
75
76       $obj->addReport(OBJECT)
77
78           See "Error handling" in Mail::Reporter
79
80       $obj->defaultTrace([LEVEL]⎪[LOGLEVEL, TRACELEVEL]⎪[LEVEL, CALLBACK])
81
82       Mail::Message::TransferEnc::Base64->defaultTrace([LEVEL]⎪[LOGLEVEL,
83       TRACELEVEL]⎪[LEVEL, CALLBACK])
84
85           See "Error handling" in Mail::Reporter
86
87       $obj->errors
88
89           See "Error handling" in Mail::Reporter
90
91       $obj->log([LEVEL [,STRINGS]])
92
93       Mail::Message::TransferEnc::Base64->log([LEVEL [,STRINGS]])
94
95           See "Error handling" in Mail::Reporter
96
97       $obj->logPriority(LEVEL)
98
99       Mail::Message::TransferEnc::Base64->logPriority(LEVEL)
100
101           See "Error handling" in Mail::Reporter
102
103       $obj->logSettings
104
105           See "Error handling" in Mail::Reporter
106
107       $obj->notImplemented
108
109           See "Error handling" in Mail::Reporter
110
111       $obj->report([LEVEL])
112
113           See "Error handling" in Mail::Reporter
114
115       $obj->reportAll([LEVEL])
116
117           See "Error handling" in Mail::Reporter
118
119       $obj->trace([LEVEL])
120
121           See "Error handling" in Mail::Reporter
122
123       $obj->warnings
124
125           See "Error handling" in Mail::Reporter
126
127       Cleanup
128
129       $obj->DESTROY
130
131           See "Cleanup" in Mail::Reporter
132
133       $obj->inGlobalDestruction
134
135           See "Cleanup" in Mail::Reporter
136

DIAGNOSTICS

138       Warning: Base64 line length not padded on 4.
139
140       While decoding base64 the data in a message body, a string was found
141       which was not padded into a multiple of four bytes.  This is illegal,
142       and therefore this data is ignored.
143
144       Error: Decoder for transfer encoding $type does not work: $@
145
146       Compiling the required transfer encoding resulted in errors, which
147       means that the decoder can not be used.
148
149       Warning: No decoder for transfer encoding $type.
150
151       A decoder for the specified type of transfer encoding is not imple‐
152       mented.
153
154       Error: Package $package does not implement $method.
155
156       Fatal error: the specific package (or one of its superclasses) does not
157       implement this method where it should. This message means that some
158       other related classes do implement this method however the class at
159       hand does not.  Probably you should investigate this and probably
160       inform the author of the package.
161

LICENSE

167       Copyrights 2001-2007 by Mark Overmeer.For other contributors see
168       ChangeLog.
169
170       This program is free software; you can redistribute it and/or modify it
171       under the same terms as Perl itself.  See
172       http://www.perl.com/perl/misc/Artistic.html
173
174
175
176perl v5.8.8                       2007-03-M2a5il::Message::TransferEnc::Base64(3)