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
7       bodies
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
23       transportable.
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
32       Extends "DESCRIPTION" in Mail::Message::TransferEnc.
33

METHODS

35       Extends "METHODS" in Mail::Message::TransferEnc.
36
37   Constructors
38       Extends "Constructors" in Mail::Message::TransferEnc.
39
40       Mail::Message::TransferEnc::Base64->new(%options)
41           Inherited, see "Constructors" in Mail::Reporter
42
43   The Encoder
44       Extends "The Encoder" in Mail::Message::TransferEnc.
45
46       Mail::Message::TransferEnc::Base64->addTransferEncoder($type, $class)
47           Inherited, see "The Encoder" in Mail::Message::TransferEnc
48
49       $obj->create($type, %options)
50           Inherited, see "The Encoder" in Mail::Message::TransferEnc
51
52       $obj->name()
53           Inherited, see "The Encoder" in Mail::Message::TransferEnc
54
55   Encoding
56       Extends "Encoding" in Mail::Message::TransferEnc.
57
58       $obj->check($body, %options)
59           Inherited, see "Encoding" in Mail::Message::TransferEnc
60
61       $obj->decode($body, %options)
62            -Option     --Defined in                --Default
63             result_type  Mail::Message::TransferEnc  <type of source body>
64
65           result_type => CLASS
66       $obj->encode($body, %options)
67           Inherited, see "Encoding" in Mail::Message::TransferEnc
68
69   Error handling
70       Extends "Error handling" in Mail::Message::TransferEnc.
71
72       $obj->AUTOLOAD()
73           Inherited, see "Error handling" in Mail::Reporter
74
75       $obj->addReport($object)
76           Inherited, see "Error handling" in Mail::Reporter
77
78       $obj->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level,
79       $callback] )
80       Mail::Message::TransferEnc::Base64->defaultTrace( [$level]|[$loglevel,
81       $tracelevel]|[$level, $callback] )
82           Inherited, see "Error handling" in Mail::Reporter
83
84       $obj->errors()
85           Inherited, see "Error handling" in Mail::Reporter
86
87       $obj->log( [$level, [$strings]] )
88       Mail::Message::TransferEnc::Base64->log( [$level, [$strings]] )
89           Inherited, see "Error handling" in Mail::Reporter
90
91       $obj->logPriority($level)
92       Mail::Message::TransferEnc::Base64->logPriority($level)
93           Inherited, see "Error handling" in Mail::Reporter
94
95       $obj->logSettings()
96           Inherited, see "Error handling" in Mail::Reporter
97
98       $obj->notImplemented()
99           Inherited, see "Error handling" in Mail::Reporter
100
101       $obj->report( [$level] )
102           Inherited, see "Error handling" in Mail::Reporter
103
104       $obj->reportAll( [$level] )
105           Inherited, see "Error handling" in Mail::Reporter
106
107       $obj->trace( [$level] )
108           Inherited, see "Error handling" in Mail::Reporter
109
110       $obj->warnings()
111           Inherited, see "Error handling" in Mail::Reporter
112
113   Cleanup
114       Extends "Cleanup" in Mail::Message::TransferEnc.
115
116       $obj->DESTROY()
117           Inherited, see "Cleanup" in Mail::Reporter
118

DIAGNOSTICS

120       Warning: Base64 line length not padded on 4.
121           While decoding base64 the data in a message body, a string was
122           found which was not padded into a multiple of four bytes.  This is
123           illegal, and therefore this data is ignored.
124
125       Error: Decoder for transfer encoding $type does not work: $@
126           Compiling the required transfer encoding resulted in errors, which
127           means that the decoder can not be used.
128
129       Warning: No decoder for transfer encoding $type.
130           A decoder for the specified type of transfer encoding is not
131           implemented.
132
133       Error: Package $package does not implement $method.
134           Fatal error: the specific package (or one of its superclasses) does
135           not implement this method where it should. This message means that
136           some other related classes do implement this method however the
137           class at hand does not.  Probably you should investigate this and
138           probably inform the author of the package.
139

LICENSE

145       Copyrights 2001-2022 by [Mark Overmeer <markov@cpan.org>]. For other
146       contributors see ChangeLog.
147
148       This program is free software; you can redistribute it and/or modify it
149       under the same terms as Perl itself.  See http://dev.perl.org/licenses/
150
151
152
153perl v5.36.0                      2023-01-M2a0il::Message::TransferEnc::Base64(3)