NAME

Mail::Message::Head::Delayed - a not-read header of a Mail::Message

CLASS INHERITANCE

Mail::Message::Head::Delayed realizes a Mail::Message::Head::Complete which is a Mail::Message::Head is a Mail::Reporter

SYNOPSIS

my Mail::Message::Head::Delayed $delayed = ...;
$delayed->isa('Mail::Message::Head')  # true
$delayed->guessBodySize               # undef
$delayed->isDelayed                   # true

DESCRIPTION

This object is used as place-holder, to be replaced by a Mail::Message::Head when someone accesses the header of a message.

METHODS

Initiation

build FIELDS

You cannot create a delayed header with fields.

new OPTIONS

OPTION               DEFAULT
field_type           'Mail::Message::Field::Fast'
log                  'WARNINGS'
message              undef
modified             <false>
trace                'WARNINGS'

field_type => CLASS

See Mail::Message::Head::new(field_type)

log => LEVEL

See Mail::Reporter::new(log)

message => MESSAGE

The message where this header belongs to.

modified => BOOLEAN

See Mail::Message::Head::new(modified)

trace => LEVEL

See Mail::Reporter::new(trace)

The Header

clone [FIELDS]

See Mail::Message::Head::Complete::clone()

isDelayed

See Mail::Message::Head::isDelayed()

isEmpty

See Mail::Message::Head::isEmpty()

isMultipart

See Mail::Message::Head::isMultipart()

message [MESSAGE]

See Mail::Message::Head::message()

modified [BOOLEAN]

See Mail::Message::Head::modified()

Constructing a Header

add FIELD | LINE | (NAME,BODY[,ATTRS])

See Mail::Message::Head::Complete::add()

delete NAME

See Mail::Message::Head::Complete::delete()

removeField FIELD

See Mail::Message::Head::Complete::removeField()

reset NAME, FIELDS

See Mail::Message::Head::Complete::reset()

set FIELD | LINE | (NAME, BODY [,ATTRS])

See Mail::Message::Head::Complete::set()

Access to the Header

addResentGroup RESENT-GROUP|DATA

See Mail::Message::Head::Complete::addResentGroup()

count NAME

See Mail::Message::Head::Complete::count()

get NAME [,INDEX]

Get the information about the header line NAME. Realization will take place.

grepNames [NAMES|ARRAY-OF-NAMES|REGEXS]

See Mail::Message::Head::Complete::grepNames()

guessBodySize

On a delayed head, this retuns undef, because when there is no header there is also no body.

For messages in directory or network organized folders, Mail::Message::size() usually will give a figure for the whole message without much cost. Subtract a few hundred bytes for the header, and you will get a good estimate.

guessTimeStamp

Make a guess about when the message was origanally posted. On a delayed head, this returns undef. For messages in directory or network organized folders, Mail::Message::timestamp() usually will give a figure without much cost.

knownNames

See Mail::Message::Head::knownNames()

names

See Mail::Message::Head::Complete::names()

nrLines

See Mail::Message::Head::Complete::nrLines()

print [FILEHANDLE]

See Mail::Message::Head::Complete::print()

printUndisclosed [FILEHANDLE]

See Mail::Message::Head::Complete::printUndisclosed()

resentGroups

See Mail::Message::Head::Complete::resentGroups()

size

See Mail::Message::Head::Complete::size()

timestamp

See Mail::Message::Head::Complete::timestamp()

toString

See Mail::Message::Head::Complete::toString()

Reading and Writing [internals]

addNoRealize FIELD

See Mail::Message::Head::addNoRealize()

addOrderedFields FIELDS

See Mail::Message::Head::addOrderedFields()

createFromLine

See Mail::Message::Head::Complete::createFromLine()

createMessageId

See Mail::Message::Head::Complete::createMessageId()

fileLocation

See Mail::Message::Head::fileLocation()

load

See Mail::Message::Head::load()

moveLocation DISTANCE

See Mail::Message::Head::moveLocation()

orderedFields

See Mail::Message::Head::orderedFields()

read PARSER

See Mail::Message::Head::read()

setNoRealize FIELD

See Mail::Message::Head::setNoRealize()

Logging and Tracing

defaultTrace [LEVEL, [LEVEL]

See Mail::Reporter::defaultTrace()

errors

See Mail::Reporter::errors()

log [LEVEL [,STRINGS]]

See Mail::Reporter::log()

report [LEVEL]

See Mail::Reporter::report()

reportAll [LEVEL]

See Mail::Reporter::reportAll()

trace [LEVEL]

See Mail::Reporter::trace()

warnings

See Mail::Reporter::warnings()

Other Methods

AUTOLOAD

See Mail::Reporter::AUTOLOAD()

DESTROY

See Mail::Reporter::DESTROY()

inGlobalDestruction

See Mail::Reporter::inGlobalDestruction()

logPriority LEVEL

See Mail::Reporter::logPriority()

logSettings

See Mail::Reporter::logSettings()

notImplemented

See Mail::Reporter::notImplemented()

SEE ALSO

A good start to read is Mail::Box-Overview. More documentation and a mailinglist are available from the project's website at http://perl.overmeer.net/mailbox/.

AUTHOR

Mark Overmeer (mark@overmeer.net) with the help of many.

VERSION

This code is beta, version 2.023.

Copyright (c) 2001-2002 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.