# Mail::Message::Head::Delayed - phpMan

## NAME
    [Mail::Message::Head::Delayed] - a not-read header of a [Mail::Message]

## INHERITANCE
     [Mail::Message::Head::Delayed] realizes a [Mail::Message::Head::Complete]

     [Mail::Message::Head::Delayed]
       is a [Mail::Message::Head]
       is a [Mail::Reporter]

## SYNOPSIS
     my $delayed = [Mail::Message::Head::Delayed]->new(...)
     $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.

    Extends "DESCRIPTION" in [Mail::Message::Head].

## OVERLOADED
    Extends "OVERLOADED" in [Mail::Message::Head].

    overload: ""
        Inherited, see "OVERLOADED" in [Mail::Message::Head]

    overload: bool
        Inherited, see "OVERLOADED" in [Mail::Message::Head]

## METHODS
    Extends "METHODS" in [Mail::Message::Head].

  Constructors
    Extends "Constructors" in [Mail::Message::Head].

    $obj->build($fields)
        You cannot create a delayed header with fields.

    [Mail::Message::Head::Delayed]->new(%options)
        Inherited, see "Constructors" in [Mail::Message::Head]

  The header
    Extends "The header" in [Mail::Message::Head].

    $obj->isDelayed()
        Inherited, see "The header" in [Mail::Message::Head]

    $obj->isEmpty()
        Inherited, see "The header" in [Mail::Message::Head]

    $obj->isModified()
        Inherited, see "The header" in [Mail::Message::Head]

    $obj->knownNames()
        Inherited, see "The header" in [Mail::Message::Head]

    $obj->message( [$message] )
        Inherited, see "The header" in [Mail::Message::Head]

    $obj->modified( [BOOLEAN] )
        Inherited, see "The header" in [Mail::Message::Head]

    $obj->orderedFields()
        Inherited, see "The header" in [Mail::Message::Head]

  Access to the header
    Extends "Access to the header" in [Mail::Message::Head].

    $obj->get( $name, [$index] )
        Get the information about the header line $name. Realization will
        take place.

    $obj->study( $name, [$index] )
        Inherited, see "Access to the header" in [Mail::Message::Head]

  About the body
    Extends "About the body" in [Mail::Message::Head].

    $obj->guessBodySize()
        On a delayed head, this returns "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.

    $obj->guessTimeStamp()
        Make a guess about when the message was originally 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.

    $obj->isMultipart()
        Inherited, see "About the body" in [Mail::Message::Head]

  Internals
    Extends "Internals" in [Mail::Message::Head].

    $obj->addNoRealize($field)
        Inherited, see "Internals" in [Mail::Message::Head]

    $obj->addOrderedFields($fields)
        Inherited, see "Internals" in [Mail::Message::Head]

    $obj->fileLocation()
        Inherited, see "Internals" in [Mail::Message::Head]

    $obj->load()
        Inherited, see "Internals" in [Mail::Message::Head]

    $obj->moveLocation($distance)
        Inherited, see "Internals" in [Mail::Message::Head]

    $obj->read($parser)
        Inherited, see "Internals" in [Mail::Message::Head]

    $obj->setNoRealize($field)
        Inherited, see "Internals" in [Mail::Message::Head]

  Error handling
    Extends "Error handling" in [Mail::Message::Head].

    $obj->AUTOLOAD()
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->addReport($object)
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level,
    $callback] )
    [Mail::Message::Head::Delayed]->defaultTrace( [$level]|[$loglevel,
    $tracelevel]|[$level, $callback] )
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->errors()
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->log( [$level, [$strings]] )
    [Mail::Message::Head::Delayed]->log( [$level, [$strings]] )
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->logPriority($level)
    [Mail::Message::Head::Delayed]->logPriority($level)
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->logSettings()
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->notImplemented()
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->report( [$level] )
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->reportAll( [$level] )
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->trace( [$level] )
        Inherited, see "Error handling" in [Mail::Reporter]

    $obj->warnings()
        Inherited, see "Error handling" in [Mail::Reporter]

  Cleanup
    Extends "Cleanup" in [Mail::Message::Head].

    $obj->DESTROY()
        Inherited, see "Cleanup" in [Mail::Reporter]

## DETAILS
    Extends "DETAILS" in [Mail::Message::Head].

## DIAGNOSTICS
    Error: Cannot build() a delayed header.
        A delayed message header cannot contain any information, so cannot
        be build. You can construct complete or subset headers.

    Error: Package $package does not implement $method.
        Fatal error: the specific package (or one of its superclasses) does
        not implement this method where it should. This message means that
        some other related classes do implement this method however the
        class at hand does not. Probably you should investigate this and
        probably inform the author of the package.

## SEE ALSO
    This module is part of Mail-Box distribution version 3.009, built on
    August 18, 2020. Website: <http://perl.overmeer.net/CPAN/>

## LICENSE
    Copyrights 2001-2020 by [Mark Overmeer]. For other contributors see
    ChangeLog.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself. See <http://dev.perl.org/licenses/>