Sponsoring The Perl Toolchain Summit 2025: Help make this important event another success Learn more

MARKOV / Mail-Message-3.016 / lib / Mail / Message / Convert / EmailSimple.pod 

            

              
—
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193

              
=encoding utf8
=head1 NAME
Mail::Message::Convert::EmailSimple - translate Mail::Message to Email::Simple vv
=head1 INHERITANCE
 Mail::Message::Convert::EmailSimple
   is a Mail::Message::Convert
   is a Mail::Reporter
=head1 SYNOPSIS
 use Mail::Message::Convert::EmailSimple;
 my $convert = Mail::Message::Convert::EmailSimple->new;
 my Mail::Message $msg    = Mail::Message->new;
 my Email::Simple $intern = $convert->export($msg);
 my Email::Simple $intern = Mail::Internet->new;
 my Mail::Message $msg    = $convert->from($intern);
 use Mail::Box::Manager;
 my $mgr     = Mail::Box::Manager->new;
 my $folder  = $mgr->open(folder => 'Outbox');
 $folder->addMessage($intern);
=head1 DESCRIPTION
The Email::Simple class is one of the base objects used by the
large set of Email* modules, which implement many e-mail needs
which are also supported by MailBox.  You can use this class to
gradularly move from a Email* based implementation into a MailBox
implementation.
The internals of this class are far from optimal.  The conversion
does work (thanks to Ricardo Signes), but is expensive in time
and memory usage.  It could easily be optimized.
Extends L<"DESCRIPTION" in Mail::Message::Convert|Mail::Message::Convert/"DESCRIPTION">.
  
=head1 METHODS
Extends L<"METHODS" in Mail::Message::Convert|Mail::Message::Convert/"METHODS">.
  
=head2 Constructors
Extends L<"Constructors" in Mail::Message::Convert|Mail::Message::Convert/"Constructors">.
  
=over 4
=item Mail::Message::Convert::EmailSimple-E<gt>B<new>(%options)
Inherited, see L<Mail::Message::Convert/"METHODS">
=back
=head2 Converting
Extends L<"Converting" in Mail::Message::Convert|Mail::Message::Convert/"Converting">.
  
=over 4
=item $obj-E<gt>B<export>($message, %options)
Returns a new Email::Simple object based on the information from
a L<Mail::Message|Mail::Message> object.  The $message specified is an
instance of a Mail::Message.
example: 
 my $convert = Mail::Message::Convert::EmailSimple->new;
 my Mail::Message  $msg   = Mail::Message->new;
 my Mail::Internet $copy  = $convert->export($msg);
=item $obj-E<gt>B<from>($object, %options)
Returns a new L<Mail::Message|Mail::Message> object based on the information from
an Email::Simple.
example: 
 my $convert = Mail::Message::Convert::EmailSimple->new;
 my Mail::Internet $msg  = Mail::Internet->new;
 my Mail::Message  $copy = $convert->from($msg);
=item $obj-E<gt>B<selectedFields>($head)
Inherited, see L<Mail::Message::Convert/"Converting">
=back
=head2 Error handling
Extends L<"Error handling" in Mail::Message::Convert|Mail::Message::Convert/"Error handling">.
  
=over 4
=item $obj-E<gt>B<AUTOLOAD>()
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<addReport>($object)
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<defaultTrace>( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )
=item Mail::Message::Convert::EmailSimple-E<gt>B<defaultTrace>( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<errors>()
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<log>( [$level, [$strings]] )
=item Mail::Message::Convert::EmailSimple-E<gt>B<log>( [$level, [$strings]] )
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<logPriority>($level)
=item Mail::Message::Convert::EmailSimple-E<gt>B<logPriority>($level)
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<logSettings>()
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<notImplemented>()
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<report>( [$level] )
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<reportAll>( [$level] )
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<trace>( [$level] )
Inherited, see L<Mail::Reporter/"Error handling">
=item $obj-E<gt>B<warnings>()
Inherited, see L<Mail::Reporter/"Error handling">
=back
=head2 Cleanup
Extends L<"Cleanup" in Mail::Message::Convert|Mail::Message::Convert/"Cleanup">.
  
=over 4
=item $obj-E<gt>B<DESTROY>()
Inherited, see L<Mail::Reporter/"Cleanup">
=back
=head1 DIAGNOSTICS
=over 4
=item 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.
=back
=head1 SEE ALSO
This module is part of Mail-Message distribution version 3.016,
built on November 27, 2024. Website: F<http://perl.overmeer.net/CPAN/>
=head1 LICENSE
Copyrights 2001-2024 by [Mark Overmeer <markov@cpan.org>]. 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 F<http://dev.perl.org/licenses/>