unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

Mail::Message::TransfeUser:ContribuMtaeidl:P:eMrelssage::TransferEnc::QuotedPrint(3pm)



NAME
       Mail::Message::TransferEnc::QuotedPrint - handle quoted-printable
       message bodies

INHERITANCE
        Mail::Message::TransferEnc::QuotedPrint
          is a Mail::Message::TransferEnc
          is a Mail::Reporter

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

DESCRIPTION
       Encode and decode message bodies for quoted-printable transfer
       encoding.  The Quoted-Printable encoding is intended to represent data
       that largely consists of bytes that correspond to printable characters
       in the ASCII character set.  Non-printable characters (as defined by
       English Americans) are represented by a triplet consisting of the
       character "=" followed by two hexadecimal digits.

METHODS
       Constructors

       Mail::Message::TransferEnc::QuotedPrint->new(OPTIONS)

           See "Constructors" in Mail::Reporter

       The Encoder

       Mail::Message::TransferEnc::QuotedPrint->addTransferEncoder(TYPE,
       CLASS)

           See "The Encoder" in Mail::Message::TransferEnc

       $obj->create(TYPE, OPTIONS)

           See "The Encoder" in Mail::Message::TransferEnc

       $obj->name

           See "The Encoder" in Mail::Message::TransferEnc

       Encoding

       $obj->check(BODY, OPTIONS)

           See "Encoding" in Mail::Message::TransferEnc

       $obj->decode(BODY, OPTIONS)

           Decoding is tricky, and not without loss of information.  Lines
           will stay separate lines, although they might have been joined
           before the encoding split them up.  Characters which are not
           printable will be replaced by their octal value, and carriage
           returns ('=0D') at end of line are removed.

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

           . result_type => CLASS

       $obj->encode(BODY, OPTIONS)

           Encoding is to quoted-printable is a careful process: All
           characters outside the normal printing range, and including '=' are
           encoded.  They are translated into a '=' followed by a two digit
           hex of the ascii value of the character.  The same treatment is for
           white-spaces at the end of a line.

           The lines which are constructed which must be 76 characters max,
           not broken on encoded characters.

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

           . result_type => CLASS

       Error handling

       $obj->AUTOLOAD

           See "Error handling" in Mail::Reporter

       $obj->addReport(OBJECT)

           See "Error handling" in Mail::Reporter

       $obj->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])

       Mail::Message::TransferEnc::QuotedPrint->defaultTrace([LEVEL]|[LOGLEVEL,
       TRACELEVEL]|[LEVEL, CALLBACK])

           See "Error handling" in Mail::Reporter

       $obj->errors

           See "Error handling" in Mail::Reporter

       $obj->log([LEVEL [,STRINGS]])

       Mail::Message::TransferEnc::QuotedPrint->log([LEVEL [,STRINGS]])

           See "Error handling" in Mail::Reporter

       $obj->logPriority(LEVEL)

       Mail::Message::TransferEnc::QuotedPrint->logPriority(LEVEL)

           See "Error handling" in Mail::Reporter

       $obj->logSettings

           See "Error handling" in Mail::Reporter

       $obj->notImplemented

           See "Error handling" in Mail::Reporter

       $obj->report([LEVEL])

           See "Error handling" in Mail::Reporter

       $obj->reportAll([LEVEL])

           See "Error handling" in Mail::Reporter

       $obj->trace([LEVEL])

           See "Error handling" in Mail::Reporter

       $obj->warnings

           See "Error handling" in Mail::Reporter

       Cleanup

       $obj->DESTROY

           See "Cleanup" in Mail::Reporter

       $obj->inGlobalDestruction

           See "Cleanup" in Mail::Reporter

DIAGNOSTICS
       Error: Decoder for transfer encoding $type does not work: $@

           Compiling the required transfer encoding resulted in errors, which
           means that the decoder can not be used.

       Warning: No decoder for transfer encoding $type.

           A decoder for the specified type of transfer encoding is not
           implemented.

       Error: Package $package does not implement $method.

           Fatal error: the specific package (or one of its superclasses) does
           not implement this method where it should. This message means that
           some other related classes do implement this method however the
           class at hand does not.  Probably you should investigate this and
           probably inform the author of the package.

SEE ALSO
       This module is part of Mail-Box distribution version 2.082, built on
       April 28, 2008. Website: http://perl.overmeer.net/mailbox/

LICENSE
       Copyrights 2001-2008 by Mark Overmeer. For other contributors see
       ChangeLog.

       This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.  See
       http://www.perl.com/perl/misc/Artistic.html



perl v5.10.0                      Mail::Message::TransferEnc::QuotedPrint(3pm)