NAME

Mail::Message::Convert - conversions between message types

CLASS HIERARCHY

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

SYNOPSIS

 use Mail::Message::Convert::SomeThing;

 my $convert = Mail::Message::Convert::SomeThing->new;
 my Mail::Message $msg   = Mail::Message->new;
 my SomeThing     $other = $convert->export($msg);

 my SomeThing     $other = SomeThing->new;
 my Mail::Message $msg   = $convert->from($other);

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

DESCRIPTION

This class is the base for various message converters, which can be used to translate to and from Mail::Message objects.

You do not have to convert into a Mail::Message explicitly, when you want to add a foreign message to Mail::Box folder.

The following converters are currently available:

• Mail::Message::Convert::MailInternet

  Converts the simple Mail::Internet messages into Mail::Message objects.

• Mail::Message::Convert::MimeEntity

  Converts the more complicated MIME::Entity messages into Mail::Message objects.

METHOD INDEX

Methods prefixed with an abbreviation are described in Mail::Reporter (MR).

The general methods for Mail::Message::Convert objects:

   MR errors                            MR new OPTIONS
      export MESSAGE, OPTIONS           MR report [LEVEL]
      from OBJECT, OPTIONS              MR reportAll [LEVEL]
   MR log [LEVEL [,STRINGS]]            MR trace [LEVEL]

The extra methods for extension writers:

   MR AUTOLOAD                          MR logPriority LEVEL
   MR DESTROY                           MR logSettings
   MR inGlobalDestruction               MR notImplemented

METHODS

export MESSAGE, OPTIONS

Returns a new message object based on the information from a Mail::Message object. The MESSAGE specified is an instance of a Mail::Message.

Examples:

 my $convert = Mail::Message::Convert::SomeThing->new;
 my Mail::Message $msg   = Mail::Message->new;
 my SomeThing     $other = $convert->export($msg);

from OBJECT, OPTIONS

Returns a new Mail::Message object based on the information from an message-type which is strange to the Mail::Box set of modules.

Examples:

 my $convert = Mail::Message::Convert::SomeThing->new;
 my SomeThing     $other = SomeThing->new;
 my Mail::Message $msg   = $convert->from($other);

SEE ALSO

Mail::Box-Overview

AUTHOR

Mark Overmeer (mailbox@overmeer.net). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

VERSION

This code is beta, version 2.010.

Copyright (c) 2001 Mark Overmeer. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.