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 mes‐
7       sage 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 encod‐
21       ing.  The Quoted-Printable encoding is intended to represent data that
22       largely consists of bytes that correspond to printable characters in
23       the ASCII character set.  Non-printable characters (as defined by Eng‐
24       lish Americans) are represented by a triplet consisting of the charac‐
25       ter "=" followed by two hexadecimal digits.
26

METHODS

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

DIAGNOSTICS

152       Error: Decoder for transfer encoding $type does not work: $@
153
154       Compiling the required transfer encoding resulted in errors, which
155       means that the decoder can not be used.
156
157       Warning: No decoder for transfer encoding $type.
158
159       A decoder for the specified type of transfer encoding is not imple‐
160       mented.
161
162       Error: Package $package does not implement $method.
163
164       Fatal error: the specific package (or one of its superclasses) does not
165       implement this method where it should. This message means that some
166       other related classes do implement this method however the class at
167       hand does not.  Probably you should investigate this and probably
168       inform the author of the package.
169

LICENSE

175       Copyrights 2001-2007 by Mark Overmeer.For other contributors see
176       ChangeLog.
177
178       This program is free software; you can redistribute it and/or modify it
179       under the same terms as Perl itself.  See
180       http://www.perl.com/perl/misc/Artistic.html
181
182
183
184perl v5.8.8                       200M7a-i0l3:-:2M5essage::TransferEnc::QuotedPrint(3)