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

1Mail::Message::TransferUEsnecr::CQounottreidbPurtieMndati(Pl3e:)r:lMeDsoscaugmee:n:tTartainosnferEnc::QuotedPrint(3)
2
3
4

NAME

6       Mail::Message::TransferEnc::QuotedPrint - handle quoted-printable
7       message bodies
8

INHERITANCE

10        Mail::Message::TransferEnc::QuotedPrint
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 => 'quoted-printable');
18

DESCRIPTION

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

METHODS

28   Constructors
29       Mail::Message::TransferEnc::QuotedPrint->new(OPTIONS)
30           See "Constructors" in Mail::Reporter
31
32   The Encoder
33       Mail::Message::TransferEnc::QuotedPrint->addTransferEncoder(TYPE,
34       CLASS)
35           See "The Encoder" in Mail::Message::TransferEnc
36
37       $obj->create(TYPE, OPTIONS)
38           See "The Encoder" in Mail::Message::TransferEnc
39
40       $obj->name
41           See "The Encoder" in Mail::Message::TransferEnc
42
43   Encoding
44       $obj->check(BODY, OPTIONS)
45           See "Encoding" in Mail::Message::TransferEnc
46
47       $obj->decode(BODY, OPTIONS)
48           Decoding is tricky, and not without loss of information.  Lines
49           will stay separate lines, although they might have been joined
50           before the encoding split them up.  Characters which are not
51           printable will be replaced by their octal value, and carriage
52           returns ('=0D') at end of line are removed.
53
54            -Option     --Defined in                --Default
55             result_type  Mail::Message::TransferEnc  <type of source body>
56
57           result_type => CLASS
58       $obj->encode(BODY, OPTIONS)
59           Encoding is to quoted-printable is a careful process: All
60           characters outside the normal printing range, and including '=' are
61           encoded.  They are translated into a '=' followed by a two digit
62           hex of the ascii value of the character.  The same treatment is for
63           white-spaces at the end of a line.
64
65           The lines which are constructed which must be 76 characters max,
66           not broken on encoded characters.
67
68            -Option     --Defined in                --Default
69             result_type  Mail::Message::TransferEnc  <type of source body>
70
71           result_type => CLASS
72
73   Error handling
74       $obj->AUTOLOAD
75           See "Error handling" in Mail::Reporter
76
77       $obj->addReport(OBJECT)
78           See "Error handling" in Mail::Reporter
79
80       $obj->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])
81           Mail::Message::TransferEnc::QuotedPrint->defaultTrace([LEVEL]|[LOGLEVEL,
82           TRACELEVEL]|[LEVEL, CALLBACK])
83
84           See "Error handling" in Mail::Reporter
85
86       $obj->errors
87           See "Error handling" in Mail::Reporter
88
89       $obj->log([LEVEL [,STRINGS]])
90           Mail::Message::TransferEnc::QuotedPrint->log([LEVEL [,STRINGS]])
91
92           See "Error handling" in Mail::Reporter
93
94       $obj->logPriority(LEVEL)
95           Mail::Message::TransferEnc::QuotedPrint->logPriority(LEVEL)
96
97           See "Error handling" in Mail::Reporter
98
99       $obj->logSettings
100           See "Error handling" in Mail::Reporter
101
102       $obj->notImplemented
103           See "Error handling" in Mail::Reporter
104
105       $obj->report([LEVEL])
106           See "Error handling" in Mail::Reporter
107
108       $obj->reportAll([LEVEL])
109           See "Error handling" in Mail::Reporter
110
111       $obj->trace([LEVEL])
112           See "Error handling" in Mail::Reporter
113
114       $obj->warnings
115           See "Error handling" in Mail::Reporter
116
117   Cleanup
118       $obj->DESTROY
119           See "Cleanup" in Mail::Reporter
120
121       $obj->inGlobalDestruction
122           See "Cleanup" in Mail::Reporter
123

DIAGNOSTICS

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-2011 by Mark Overmeer. For other contributors see
146       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
150       http://www.perl.com/perl/misc/Artistic.html
151
152
153
154perl v5.12.3                      201M1a-i0l1:-:2M6essage::TransferEnc::QuotedPrint(3)