NAME

Mail::Message::Part - a part of a message, but a message by itself

INHERITANCE

Mail::Message::Part
  is a Mail::Message
  is a Mail::Reporter

SYNOPSIS

my Mail::Message $message = ...;
if($message->isMultipart) {
   my Mail::Message::Part $part;
   foreach $part ($message->body->parts) {
      $part->print(\*OUT);
      my $attached_head = $part->head;
      my $attached_body = $part->body;      # encoded as read
      my $attached_body = $part->decoded;   # transfer-encoding removed
   }
}

DESCRIPTION

A "Mail::Message::Part" object contains a message which is included in the body of another message. For instance attachments are parts.

READ Mail::Message FIRST. A part is a special message: it has a reference to its parent message, and will usually not be sub-classed into mail folder specific variants.

Extends "DESCRIPTION" in Mail::Message.

METHODS

Extends "METHODS" in Mail::Message.

Constructors

Extends "Constructors" in Mail::Message.

$obj->clone(%options)

Inherited, see "Constructors" in Mail::Message

$class->new(%options)

Create a message part. Improves base, see "Constructors" in Mail::Reporter

-Option    --Defined in     --Default
 body        Mail::Message    undef
 body_type   Mail::Message    Mail::Message::Body::Lines
 container                    <required>
 deleted     Mail::Message    false
 field_type  Mail::Message    undef
 head        Mail::Message    <empty header>
 head_type   Mail::Message    Mail::Message::Head::Complete
 labels      Mail::Message    +{}
 messageId   Mail::Message    undef
 message_id  Mail::Message    undef
 modified    Mail::Message    false
 trusted     Mail::Message    false

body => $object
body_type => $class
container => BODY: Reference to the parental Mail::Message::Body object where this part is a member of. That object may be a Mail::Message::Body::Multipart or a Mail::Message::Body::Nested.
deleted => BOOLEAN
field_type => $class
head => $object
head_type => $class
labels => \@pairs|\%settings
messageId => $id
message_id => $id
modified => BOOLEAN
trusted => BOOLEAN

Attributes

Extends "Attributes" in Mail::Message.

$obj->bodyType(): Inherited, see "Attributes" in Mail::Message
$obj->fieldType(): Inherited, see "Attributes" in Mail::Message
$obj->headType(): Inherited, see "Attributes" in Mail::Message
$obj->messageId(): Inherited, see "Attributes" in Mail::Message

Constructing a message

Extends "Constructing a message" in Mail::Message.

$obj->bounce( [<$rg_object|%options>] )

Inherited, see "Constructing a message" in Mail::Message::Construct::Bounce

$class->build( [$message|$part|$body], @fields, %options )

Inherited, see "Constructing a message" in Mail::Message::Construct::Build

$class->buildFromBody($body, $container, $headers)

Shape a message part around a $body. Bodies have information about their content in them, which is used to construct a header for the message. Next to that, more $headers can be specified. No headers are obligatory. No extra headers are fabricated automatically. Improves base, see "Constructing a message" in Mail::Message::Construct::Build

» example:

my $multi = Mail::Message::Body::Multipart->new;
my $part  = Mail::Message::Part->buildFromBody($body, $multi);

$obj->forward(%options)