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
27       Extends "DESCRIPTION" in Mail::Message::TransferEnc.
28

METHODS

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

DIAGNOSTICS

134       Error: Decoder for transfer encoding $type does not work: $@
135           Compiling the required transfer encoding resulted in errors, which
136           means that the decoder can not be used.
137
138       Warning: No decoder for transfer encoding $type.
139           A decoder for the specified type of transfer encoding is not
140           implemented.
141
142       Error: Package $package does not implement $method.
143           Fatal error: the specific package (or one of its superclasses) does
144           not implement this method where it should. This message means that
145           some other related classes do implement this method however the
146           class at hand does not.  Probably you should investigate this and
147           probably inform the author of the package.
148

LICENSE

154       Copyrights 2001-2022 by [Mark Overmeer <markov@cpan.org>]. For other
155       contributors see ChangeLog.
156
157       This program is free software; you can redistribute it and/or modify it
158       under the same terms as Perl itself.  See http://dev.perl.org/licenses/
159
160
161
162perl v5.36.0                      202M2a-i0l7:-:2M2essage::TransferEnc::QuotedPrint(3)