Constructors

Mail::Message::Replace::MailHeader->build( [PAIR|$field], ... )

Inherited, see "Constructors" in Mail::Message::Head::Complete

$obj->clone( [@names|ARRAY|Regexps] )

Inherited, see "Constructors" in Mail::Message::Head::Complete

Mail::Message::Replace::MailHeader->new( [$arg], %options )

The $arg is an array with header lines.

 -Option    --Defined in         --Default
  FoldLength                       79
  MailFrom                         'KEEP'
  Modify                           <false>
  field_type  Mail::Message::Head  Mail::Message::Field::Fast
  log         Mail::Reporter       'WARNINGS'
  message     Mail::Message::Head  undef
  modified    Mail::Message::Head  <false>
  trace       Mail::Reporter       'WARNINGS'
    

The header

$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->nrLines()

Inherited, see "The header" in Mail::Message::Head::Complete

$obj->orderedFields()

Inherited, see "The header" in Mail::Message::Head

$obj->size()

Inherited, see "The header" in Mail::Message::Head::Complete

$obj->wrap($integer)

Inherited, see "The header" in Mail::Message::Head::Complete

Access to the header

$obj->add( $line, [$index] )

Add a header line, which simply calls "Mail::Message::Head::add()" on the header for the specified $line. The $index is ignored, the unfolded body of the field is returned.

$obj->addListGroup($object)

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->addResentGroup($resent_group|$data)

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->addSpamGroup($object)

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->count($name)

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->delete( $tag, [$index] )

Delete the fields with the specified $tag. The deleted fields are returned. If no index is given, then all are removed.

$obj->get( $name, [$index] )

Get all the header fields with the specified $name. In scalar context, only the first fitting $name is returned. Even when only one $name is specified, multiple lines may be returned in list context: some fields appear more than once in a header.

$obj->grepNames( [@names|ARRAY|Regexps] )

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->listGroup()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->names()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->print( [$fh] )

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->printSelected($fh, <STRING|Regexp>, ...)

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->printUndisclosed( [$fh] )

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->removeContentInfo()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->removeField($field)

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->removeFields( <STRING|Regexp>, ... )

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->removeFieldsExcept( <STRING|Regexp>, ... )

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->removeListGroup()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->removeResentGroups()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->removeSpamGroups()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->replace( $tag, $line, [$index] )

Replace the field named $tag. from place $index (by default the first) by the $line. When $tag is "undef", it will be extracted from the $line first. This calls Mail::Message::Head::Complete::reset() on the message's head.

$obj->resentGroups()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->reset($name, @fields)

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->set( $field | $line | <$name, $body, [$attrs]> )

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->spamDetected()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->spamGroups( [$names] )

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->string()

Inherited, see "Access to the header" in Mail::Message::Head::Complete

$obj->study( $name, [$index] )

Inherited, see "Access to the header" in Mail::Message::Head

About the body

$obj->guessBodySize()

Inherited, see "About the body" in Mail::Message::Head

$obj->guessTimeStamp()

Inherited, see "About the body" in Mail::Message::Head::Complete

$obj->isMultipart()

Inherited, see "About the body" in Mail::Message::Head

$obj->recvstamp()

Inherited, see "About the body" in Mail::Message::Head::Complete

$obj->timestamp()

Inherited, see "About the body" in Mail::Message::Head::Complete

Internals

$obj->addNoRealize($field)

Inherited, see "Internals" in Mail::Message::Head

$obj->addOrderedFields($fields)

Inherited, see "Internals" in Mail::Message::Head

$obj->createFromLine()

Inherited, see "Internals" in Mail::Message::Head::Complete

$obj->createMessageId()

Inherited, see "Internals" in Mail::Message::Head::Complete

$obj->fileLocation()

Inherited, see "Internals" in Mail::Message::Head

$obj->load()

Inherited, see "Internals" in Mail::Message::Head

$obj->messageIdPrefix( [$prefix, [$hostname]|CODE] )

Mail::Message::Replace::MailHeader->messageIdPrefix( [$prefix, [$hostname]|CODE] )

Inherited, see "Internals" in Mail::Message::Head::Complete

$obj->moveLocation($distance)

Inherited, see "Internals" in Mail::Message::Head

$obj->setNoRealize($field)

Inherited, see "Internals" in Mail::Message::Head

Error handling

$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::Replace::MailHeader->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::Replace::MailHeader->log( [$level, [$strings]] )

Inherited, see "Error handling" in Mail::Reporter

$obj->logPriority($level)

Mail::Message::Replace::MailHeader->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

$obj->DESTROY()

Inherited, see "Cleanup" in Mail::Reporter

Access to the header

Simulating Mail::Header

$obj->as_string()

Returns the whole header as one big scalar. Calls Mail::Message::Head::Complete::string().

$obj->cleanup()

Cleanup memory usage. Not needed here.

$obj->combine( $tag, [$with] )

I do not see any valid reason for this command, so did not implement it.

$obj->dup()

Duplicate the header, which is simply clone().

$obj->empty()

Clean-out the whole hash. Better not use this (simply create another header object), although it should work.

$obj->exists()

Returns whether there are any fields.

$obj->extract(ARRAY)

Extract (and remove) header fields from the array.

$obj->fold( [$length] )

Refold all fields in the header, to $length or whatever fold_length() returns.

$obj->fold_length( [[$tag], $length] )

Returns the line wrap, optionally after setting it to $length. The old value is returned. The $tag argument is ignored, because it is silly to have different lines fold in different ways. This method cannot be called statically anymore.

$obj->header( [ARRAY] )

Extract the fields from the ARRAY, if specified, and then fold the fields. Returned is an array with all fields, produced via orderedFields().

$obj->header_hashref(HASH)

If you are using this method, you must be stupid... anyway: I do not want to support it for now: use add() and friends.

$obj->mail_from( ['IGNORE'|'ERROR'|'COERCE'|'KEEP'] )

What to do when a header line in the form `From ' is encountered. Valid values are "IGNORE" - ignore and discard the header, "ERROR" - invoke an error (call die), "COERCE" - rename them as Mail-From and "KEEP" - keep them.

$obj->modify( [BOOLEAN] )

Refold the headers when they are added.

$obj->read($file)

Read the header from the $file.

$obj->tags()

Returns all the names of fields, implemented by Mail::Message::Head::Complete::names().

$obj->unfold( [$tag] )

Remove the folding for all instances of $tag, or all fields at once.

The nasty bits

$obj->isa($class)

Mail::Message::Replace::MailHeader->isa($class)

Of course, the "isa()" class inheritance check should not see our nasty trick.