Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
Base64.pm	1.62 KB	-rw-r--r--
Base64.pod	5.34 KB	-rw-r--r--
Binary.pm	1.37 KB	-rw-r--r--
Binary.pod	1.75 KB	-rw-r--r--
EightBit.pm	1.53 KB	-rw-r--r--
EightBit.pod	2.22 KB	-rw-r--r--
QuotedPrint.pm	1.19 KB	-rw-r--r--
QuotedPrint.pod	5.77 KB	-rw-r--r--
SevenBit.pm	1.54 KB	-rw-r--r--
SevenBit.pod	2.27 KB	-rw-r--r--

Code Editor : Base64.pod

=encoding utf8

=head1 NAME

Mail::Message::TransferEnc::Base64 - encode/decode base64 message bodies

=head1 INHERITANCE

Mail::Message::TransferEnc::Base64
   is a Mail::Message::TransferEnc
   is a Mail::Reporter

=head1 SYNOPSIS

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

=head1 DESCRIPTION

Encode or decode message bodies with base64.  The e-mail protocol and
user agents can not handle binary data.  Therefore, binary data -but
even sometimes non-binary data- is encoded into ASCII, this is
transportable.

Base64 re-groups the bits of bytes, and maps them on characters. The
data contains bytes of 8 bits (an I<octet>).  These are repacked into
groups of 6 bits, pointing in an array of characters containing
C<[A-Za-z0-9+/]>.  This way, three data bytes become 4 base64 bytes.
The encoded data will be trailed by C<'='> characters to align on
four bytes.

Extends L<"DESCRIPTION" in Mail::Message::TransferEnc|Mail::Message::TransferEnc/"DESCRIPTION">.
 
=head1 METHODS

Extends L<"METHODS" in Mail::Message::TransferEnc|Mail::Message::TransferEnc/"METHODS">.
 
=head2 Constructors

Extends L<"Constructors" in Mail::Message::TransferEnc|Mail::Message::TransferEnc/"Constructors">.
 
=over 4

=item Mail::Message::TransferEnc::Base64-E<gt>B<new>(%options)

Inherited, see L<Mail::Reporter/"Constructors">

=back

=head2 The Encoder

Extends L<"The Encoder" in Mail::Message::TransferEnc|Mail::Message::TransferEnc/"The Encoder">.
 
=over 4

=item Mail::Message::TransferEnc::Base64-E<gt>B<addTransferEncoder>($type, $class)

Inherited, see L<Mail::Message::TransferEnc/"The Encoder">

=item $obj-E<gt>B<create>($type, %options)

Inherited, see L<Mail::Message::TransferEnc/"The Encoder">

=item $obj-E<gt>B<name>()

Inherited, see L<Mail::Message::TransferEnc/"The Encoder">

=back

=head2 Encoding

Extends L<"Encoding" in Mail::Message::TransferEnc|Mail::Message::TransferEnc/"Encoding">.
 
=over 4

=item $obj-E<gt>B<check>($body, %options)

Inherited, see L<Mail::Message::TransferEnc/"Encoding">

=item $obj-E<gt>B<decode>($body, %options)

-Option     --Defined in                --Default
  result_type  Mail::Message::TransferEnc  <type of source body>

=over 2

=item result_type => CLASS

=back

=item $obj-E<gt>B<encode>($body, %options)

Inherited, see L<Mail::Message::TransferEnc/"Encoding">

=back

=head2 Error handling

Extends L<"Error handling" in Mail::Message::TransferEnc|Mail::Message::TransferEnc/"Error handling">.
 
=over 4

=item $obj-E<gt>B<AUTOLOAD>()