NAME

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

CLASS HIERARCHY

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

SYNOPSIS

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

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 octet). These are repacked into groups of 6 bits, pointing in an array of characters containing [A-Za-z0-9+/]. This way, three data bytes become 4 base64 bytes. The encoded data will be trailed by '=' characters to align on four bytes.

METHOD INDEX

Methods prefixed with an abbreviation are described in Mail::Reporter (MR), Mail::Message::TransferEnc (MMT).

The general methods for Mail::Message::TransferEnc::Base64 objects:

MMT check BODY [, OPTIONS]           MMT name
MMT create TYPE, OPTIONS                 new OPTIONS
MMT decode BODY [, OPTIONS]           MR report [LEVEL]
MMT encode BODY [, OPTIONS]           MR reportAll [LEVEL]
 MR errors                            MR trace [LEVEL]
 MR log [LEVEL [,STRINGS]]            MR warnings

The extra methods for extension writers:

 MR AUTOLOAD                          MR inGlobalDestruction
 MR DESTROY                           MR logPriority LEVEL
MMT addTransferEncoder TYPE, CLASS    MR logSettings

METHODS

new OPTIONS

OPTION            DESCRIBED IN          DEFAULT
log               Mail::Reporter        'WARNINGS'
trace             Mail::Reporter        'WARNINGS'

METHODS for extension writers

SEE ALSO

Mail::Box-Overview

For support and additional documentation, see http://perl.overmeer.net/mailbox/

AUTHOR

Mark Overmeer (mailbox@overmeer.net). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

VERSION

This code is beta, version 2.013.

Copyright (c) 2001-2002 Mark Overmeer. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.