NAME

Mail::Box::MH::Message - one message in a MH-folder

CLASS HIERARCHY

Mail::Box::MH::Message
is a Mail::Box::Message
is a Mail::Message + ::Construct
is a Mail::Reporter

SYNOPSIS

my $folder = new Mail::Box::MH ...
my $message = $folder->message(10);

DESCRIPTION

A Mail::Box::MH::Message represents one message in an MH-folder. Each message is stored in a separate file.

The bottom of this page provides more details about details about the implementation, but first the use.

METHOD INDEX

The general methods for Mail::Box::MH::Message objects:

MMC bounce OPTIONS                    MM modified [BOOL]
MMC build [MESSAGE|BODY], CONTENT        new OPTIONS
MMC buildFromBody BODY, HEADERS       MM nrLines
MBM copyTo FOLDER                     MM parent
 MM decoded OPTIONS                   MM parts
MBM delete                            MM print [FILEHANDLE]
MBM deleted [BOOL]                    MM printUndisclosed [FILEHANDLE]
 MM destinations                     MMC quotePrelude [STRING|FIELD]
 MM encode OPTIONS                   MMC reply OPTIONS
 MR errors                           MMC replySubject STRING
    filename [FILENAME]               MR report [LEVEL]
MBM folder [FOLDER]                   MR reportAll [LEVEL]
 MM from|to|cc|bcc|date               MM send [MAILER], OPTIONS
 MM get FIELD                        MBM seqnr [INTEGER]
 MM guessTimestamp                   MBM setLabel LIST
 MM isDummy                          MBM shortString
 MM isMultipart                       MM size
 MM isPart                            MM subject
MBM label STRING [ ,STRING ,...]      MM timestamp
MBM labels                            MM toplevel
 MR log [LEVEL [,STRINGS]]            MR trace [LEVEL]
 MM messageId                         MR warnings

The extra methods for extension writers:

 MR AUTOLOAD                             loadHead
 MM DESTROY                           MR logPriority LEVEL
 MM body [BODY]                       MR logSettings
 MM clone                             MR notImplemented
 MM coerce MESSAGE                       parser
MBM diskDelete                        MM read PARSER, [BODYTYPE]
 MM head [HEAD]                      MBM readBody PARSER, HEAD [, BO...
 MR inGlobalDestruction               MM readHead PARSER [,CLASS]
 MM isDelayed                         MM storeBody BODY

Methods prefixed with an abbreviation are described in the following manual-pages:

 MM = L<Mail::Message>
 MR = L<Mail::Reporter>
MBM = L<Mail::Box::Message>
MMC = L<Mail::Message::Construct>

METHODS

new OPTIONS

Messages in directory-based folders use the following options:

OPTION      DESCRIBED IN            DEFAULT
body        Mail::Message           undef
deleted     Mail::Box::Message      0
filename    Mail::Box::MH::Message  undef
folder      Mail::Box::Message      <required>
head        Mail::Message           undef
head_wrap   Mail::Message           undef
labels      Mail::Box::Message      []
log         Mail::Reporter          'WARNINGS'
messageId   Mail::Message           undef
modified    Mail::Message           0
size        Mail::Box::Message      undef
trace       Mail::Reporter          'WARNINGS'
trusted     Mail::Message           0

Only for extension writers:

OPTION      DESCRIBED IN            DEFAULT
body_type   Mail::Box::Message      <not used>
field_type  Mail::Message           undef
head_type   Mail::Message           'Mail::Message::Head::Complete'

• filename => FILENAME

  The file where the message is stored in.

filename [FILENAME]

Returns the name of the file in which this message is actually stored. This will return undef when the message is not stored in a file.

METHODS for extension writers

parser

Create and return a parser for this message (-file).

loadHead

This method is called by the autoloader when the header of the message is needed.

IMPLEMENTATION

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.00_20.

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.