Mail::Message::Construct::Text(3pm)

Usage

  my $text = $msg->string;
  my $text = "$msg";   # via overload
  my @text = $msg->lines;
  my @text = @$lines;  # via overload
  my $fh   = $msg->file;
  my $line = <$fh>;
  $msg->printStructure;

Overview

Complex functionality on Mail::Message objects is implemented in different files which are autoloaded. This file implements the functionality related to creating message replies.

Methods

The whole message as text

$obj->file(): Returns the message as file-handle.

$obj->lines(): Returns the whole message as set of lines. In LIST context, copies of the lines are returned. In SCALAR context, a reference to an array of lines is returned.

$obj->printStructure( [$fh|undef],[$indent] )

Print the structure of a message to the specified $fh or the selected filehandle. When explicitly "undef" is specified as handle, then the output will be returned as string.

The message's subject and the types of all composing parts are displayed.

$indent specifies the initial indentation string: it is added in front of each line. The $indent must contain at least one white-space.

» example:

  my $msg = ...;
  $msg->printStructure(\*OUTPUT);
  $msg->printStructure;
  my $struct = $msg->printStructure(undef);
  # Possible output for one message:
  multipart/mixed: forwarded message from Pietje Puk (1550 bytes)
     text/plain (164 bytes)
     message/rfc822 (1043 bytes)
        multipart/alternative: A multipart alternative (942 bytes)
           text/plain (148 bytes, deleted)
           text/html (358 bytes)

$obj->string(): Returns the whole message as string.

Flags

Releases

12 releases since Debian 3.1 (Sarge); the text changed 11 times.

3.1
4.0
5.0
6.0
7
8
9
10
11
12
13
Arch