Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
EmailSimple.pm	1.16 KB	-rw-r--r--
EmailSimple.pod	4.92 KB	-rw-r--r--
Html.pm	4.12 KB	-rw-r--r--
Html.pod	6.5 KB	-rw-r--r--
HtmlFormatPS.pm	1.25 KB	-rw-r--r--
HtmlFormatPS.pod	4.2 KB	-rw-r--r--
HtmlFormatText.pm	1.32 KB	-rw-r--r--
HtmlFormatText.pod	4.53 KB	-rw-r--r--
MailInternet.pm	2.07 KB	-rw-r--r--
MailInternet.pod	4.79 KB	-rw-r--r--
MimeEntity.pm	1.22 KB	-rw-r--r--
MimeEntity.pod	5.2 KB	-rw-r--r--
TextAutoformat.pm	1.02 KB	-rw-r--r--
TextAutoformat.pod	4.24 KB	-rw-r--r--

Code Editor : MimeEntity.pod

=encoding utf8

=head1 NAME

Mail::Message::Convert::MimeEntity - translate Mail::Message to MIME::Entity vv

=head1 INHERITANCE

Mail::Message::Convert::MimeEntity
   is a Mail::Message::Convert
   is a Mail::Reporter

=head1 SYNOPSIS

use Mail::Message::Convert::MimeEntity;
 my $convert = Mail::Message::Convert::MimeEntity->new;

my Mail::Message $msg    = Mail::Message->new;
 my MIME::Entity  $entity = $convert->export($msg);

my MIME::Entity  $entity = MIME::Entity->new;
 my Mail::Message $msg    = $convert->from($entity);

use Mail::Box::Manager;
 my $mgr     = Mail::Box::Manager->new;
 my $folder  = $mgr->open(folder => 'Outbox');
 $folder->addMessage($entity);

=head1 DESCRIPTION

The MIME::Entity extends L<Mail::Internet|Mail::Internet> message with multiparts
and more methods.  The L<Mail::Message|Mail::Message> objects are more flexible
in how the message parts are stored, and uses separate header and body
objects.

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::MimeEntity-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, [$parser] )

Returns a new L<MIME::Entity> message object based on the
information from the $message, which is a L<Mail::Message|Mail::Message> object.

You may want to supply your own $parser, which is a MIME::Parser
object, to change the parser flags.  Without a $parser object, one
is created for you, with all the default settings.

If C<undef> is passed, in place of a $message, then an empty list is
returned.  When the parsing failes, then L<MIME::Parser> throws an
exception.

example:

my $convert = Mail::Message::Convert::MimeEntity->new;
 my Mail::Message $msg  = Mail::Message->new;
 my manual MIME::Entity  $copy = $convert->export($msg);

=item $obj-E<gt>B<from>($mime_object)

Returns a new L<Mail::Message|Mail::Message> object based on the information from
the specified L<MIME::Entity>.  If the conversion fails, the C<undef>
is returned.  If C<undef> is passed in place of an OBJECT, then an
empty list is returned.

example:

my $convert = Mail::Message::Convert::MimeEntity->new;
 my MIME::Entity  $msg  = MIME::Entity->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>()