Forward the content of this message. The body of the message to be forwarded
is encapsulated in some accompanying text (if you have no wish for that, than
bounce
is your choice). A Mail::Message object is returned on success.
You may forward a whole message, but also message parts.
You may wish to overrule some of the default header settings for the
reply immediately, or you may do that later with set
on the header.
When a multi-part body is encountered, and the message is included to
ATTACH, the parts which look like signatures will be removed. If only
one message remains, it will be the added as single attachment, otherwise
a nested multipart will be the result. The value of this option does not
matter, as long as it is present. See Mail::Message::Body::Multipart
.
Option | Default |
---|---|
Bcc | undef |
Cc | undef |
Date | <now> |
From | <'to' in current> |
Message-ID | <uniquely generated> |
Subject | |
To | <required> |
body | undef |
include | <if body then |
preamble |
|
signature | undef |
Unknown alternative for the forward(include). Valid choices are
NO
, INLINE
, ATTACH
, and ENCAPSULATE
.
If a forward message is created, a destination address must be specified.
Forward the message as flat attachment to the specified preamble
. You
can specify all options available to forward()
, although a preamble
which is provided as body object is required, and any specified body
is ignored.
Option | Default |
---|---|
preamble | <required> |
Like forwardAttach(), but in this case the original message is first encapsulated as nested message in a Mail::Message::Body::Nested, and then joint into a multipart.
You can specify all options available to forward()
, although a preamble
which is provided as body object is required, and any specified body
is ignored. Signatures are not stripped. Signatures are not stripped.
Option | Default |
---|---|
preamble | <required> |
This method is equivalent in behavior to forward() with the
option include
set to 'INLINE'
. You can specify most of
the fields which are available to forward() except
include
and body
.
Option | Default |
---|---|
is_attached |
|
max_signature |
|
postlude | undef |
prelude | undef |
quote | undef |
strip_signature |
|
Construct a forward, where the whole body of the message is already constructed. That complex body is usually produced in forwardInline(), forwardAttach(), or forwardEncapsulate().
The OPTIONS are the same as for forward()
except that body
is
required. Some other options, like preamble
, are ignored.
Option | Default |
---|---|
body | <required> |
Added after the forwarded message.
---- END forwarded message
Create a few lines to be included before the forwarded message content. The return is an array of lines.
---- BEGIN forwarded message From: him@somewhere.else.nl (Original Sender) To: me@example.com (Me the receiver) Cc: the.rest@world.net Date: Wed, 9 Feb 2000 15:44:05 -0500 <blank line>
Create a subject for a message which is a forward from this one. This routine tries to count the level of reply in subject field, and transform it into a standard form. Please contribute improvements.
subject --> Forw: subject Re: subject --> Forw: Re: subject Re[X]: subject --> Forw: Re[X]: subject <blank> --> Forwarded