Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MboxParser::Mail::ConvUserbContributed Perl DoMboxParser::Mail::Convertable(3)

NAME
       Mail::MboxParser::Mail::Convertable - convert mail for sending etc.

SYNOPSIS
	   use Mail::MboxParser;

	   [...]

	   # $msg is a Mail::MboxParser::Mail-object
	   my $mail = $msg->make_convertable;

	   $mail->delete_from_header('date', 'message-id');
	   $mail->replace_in_header('to', 'john.doe@foobar.com');
	   $mail->add_to_header( ['cc',	'john.does.brother@foobar.com'],
				 where => 'BEHIND' );
	   $mail->send('sendmail');

DESCRIPTION
       This class adds means to	convert	an email object	into something that
       could be	send via SMTP, NNTP or dumped to a file	or filehandle.
       Therefore, methods are provided that change the structure of an email
       which includes adding and removing of header-fields, MIME-parts etc and
       transforming them into objects of related modules.

       Currently, only basic manipulation of the header	and sending using
       Mail::Mailer is provided. More is to come soon.

       This class works	non-destructive. You first create a Convertable-object
       and do any modifications	on this	while the Mail-object from which it
       was derived will	not be touched.

METHODS
       delete_from_header(header-fields)
	   Given a list	of header-field	names, these fields will be removed
	   from	the header. If you want	to re-send a message, you could	for
	   instance remove the cc-field	cause otherwise	the message would be
	   carbon-copied to the	addresses listed in the	cc-field.

       add_to_header(array-ref)
       add_to_header(array-ref,	where => 'BEFORE' | 'BEHIND')
	   add_to_header() takes a reference to	a two-element list whose first
	   element specifies the header-field to add or	to add to while	the
	   second elements specifies the data that should be added. 'where'
	   specifies whether to	add at the beginning or	at the end of the
	   header. Defaults to 'BEHIND'	if not given.

       replace_in_header(header-field, new_data)
	   First element must be the header-field to be	replaced while the
	   second argument must	be a string indicating what will be the	new
	   content of the header-field.

       send(command, args)
	   Literally inherited from Mail::Internet. Commands can be "mail"
	   (using the UNIX-mail	program), "sendmail" (using a configured
	   sendmail or compatible MTA like exim), "smtp" (for using Net::SMTP)
	   and "test" which will only display what would be sent using
	   /bin/echo. Additional arguments will	be passed on to
	   Mail::Mailer->new() which is	in fact	what Mail::Internet->send()
	   uses.

	   For more details, see Mail::Mailer

VERSION
       This is version 0.55.

AUTHOR AND COPYRIGHT
       Tassilo von Parseval <tassilo.von.parseval@rwth-aachen.de>

       Copyright (c)  2001-2005	Tassilo	von Parseval.  This program is free
       software; you can redistribute it and/or	modify it under	the same terms
       as Perl itself.

SEE ALSO
       Mail::Internet, Mail::Mailer

perl v5.24.1			  2005-12-08  MboxParser::Mail::Convertable(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | VERSION | AUTHOR AND COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Mail::MboxParser::Mail::Convertable&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help