Mail::Message::Convert::EmailSimple(3pm)

1Mail::Message::Convert:U:sEemraiCloSnitmrpilbeu(t3e)d PeMralilD:o:cMuemsesnatgaet:i:oCnonvert::EmailSimple(3)
2
3
4

NAME

6       Mail::Message::Convert::EmailSimple - translate Mail::Message to
7       Email::Simple vv
8

INHERITANCE

10        Mail::Message::Convert::EmailSimple
11          is a Mail::Message::Convert
12          is a Mail::Reporter
13

SYNOPSIS

15        use Mail::Message::Convert::EmailSimple;
16        my $convert = Mail::Message::Convert::EmailSimple->new;
17
18        my Mail::Message $msg    = Mail::Message->new;
19        my Email::Simple $intern = $convert->export($msg);
20
21        my Email::Simple $intern = Mail::Internet->new;
22        my Mail::Message $msg    = $convert->from($intern);
23
24        use Mail::Box::Manager;
25        my $mgr     = Mail::Box::Manager->new;
26        my $folder  = $mgr->open(folder => 'Outbox');
27        $folder->addMessage($intern);
28

DESCRIPTION

30   Converters between message objects
31   Other converters
32       The Email::Simple class is one of the base objects used by the large
33       set of Email* modules, which implement many e-mail needs which are also
34       supported by MailBox.  You can use this class to gradularly move from a
35       Email* based implementation into a MailBox implementation.
36
37       The internals of this class are far from optimal.  The conversion does
38       work (thanks to Ricardo Signes), but is expensive in time and memory
39       usage.  It could easily be optimized.
40

METHODS

42   Constructors
43       Mail::Message::Convert::EmailSimple->new(OPTIONS)
44           See "METHODS" in Mail::Message::Convert
45
46   Converting
47       $obj->export(MESSAGE, OPTIONS)
48           Returns a new Email::Simple object based on the information from a
49           Mail::Message object.  The MESSAGE specified is an instance of a
50           Mail::Message.
51
52           example:
53
54            my $convert = Mail::Message::Convert::EmailSimple->new;
55            my Mail::Message  $msg   = Mail::Message->new;
56            my Mail::Internet $copy  = $convert->export($msg);
57
58       $obj->from(OBJECT, OPTIONS)
59           Returns a new Mail::Message object based on the information from an
60           Email::Simple.
61
62           example:
63
64            my $convert = Mail::Message::Convert::EmailSimple->new;
65            my Mail::Internet $msg  = Mail::Internet->new;
66            my Mail::Message  $copy = $convert->from($msg);
67
68       $obj->selectedFields(HEAD)
69           See "Converting" in Mail::Message::Convert
70
71   Error handling
72       $obj->AUTOLOAD
73           See "Error handling" in Mail::Reporter
74
75       $obj->addReport(OBJECT)
76           See "Error handling" in Mail::Reporter
77
78       $obj->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])
79           Mail::Message::Convert::EmailSimple->defaultTrace([LEVEL]|[LOGLEVEL,
80           TRACELEVEL]|[LEVEL, CALLBACK])
81
82           See "Error handling" in Mail::Reporter
83
84       $obj->errors
85           See "Error handling" in Mail::Reporter
86
87       $obj->log([LEVEL [,STRINGS]])
88           Mail::Message::Convert::EmailSimple->log([LEVEL [,STRINGS]])
89
90           See "Error handling" in Mail::Reporter
91
92       $obj->logPriority(LEVEL)
93           Mail::Message::Convert::EmailSimple->logPriority(LEVEL)
94
95           See "Error handling" in Mail::Reporter
96
97       $obj->logSettings
98           See "Error handling" in Mail::Reporter
99
100       $obj->notImplemented
101           See "Error handling" in Mail::Reporter
102
103       $obj->report([LEVEL])
104           See "Error handling" in Mail::Reporter
105
106       $obj->reportAll([LEVEL])
107           See "Error handling" in Mail::Reporter
108
109       $obj->trace([LEVEL])
110           See "Error handling" in Mail::Reporter
111
112       $obj->warnings
113           See "Error handling" in Mail::Reporter
114
115   Cleanup
116       $obj->DESTROY
117           See "Cleanup" in Mail::Reporter
118
119       $obj->inGlobalDestruction
120           See "Cleanup" in Mail::Reporter
121

DIAGNOSTICS

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

LICENSE

135       Copyrights 2001-2011 by Mark Overmeer. For other contributors see
136       ChangeLog.
137
138       This program is free software; you can redistribute it and/or modify it
139       under the same terms as Perl itself.  See
140       http://www.perl.com/perl/misc/Artistic.html
141
142
143
144perl v5.12.3                      2011-01M-a2i6l::Message::Convert::EmailSimple(3)