NAME

$obj->isDummy

$obj->isPart

$obj->messageId

$obj->nntppost(OPTIONS)

Send an NNTP message (newsgroup message), which is equivalent to Mail::Transport::NNTP or Mail::Message::send() with via 'nntp'.

Option--Default
Debug   <false>
Host    <from Net::Config>
Port    119

. Debug => BOOLEAN

. Host => HOSTNAME

. Port => INTEGER

$obj->print([FILEHANDLE])

Prints the whole message to the specified FILEHANDLE, which default to STDOUT. This calls Mail::Message::print().

$obj->send(TYPE, OPTIONS)

Send via Mail Transfer Agents (MUA). These will be handled by various Mail::Transport::Send extensions. The test TYPE is not supported.

$obj->size

$obj->toplevel

$obj->write([FILEHANDLE])

The header

$obj->add(LINES)

Add header lines, which simply calls Mail::Message::Head::add() on the header for each specified LINE. The last added LINE is returned.

$obj->bcc

$obj->cc

$obj->clean_header

Not to be used, replaced by header().

$obj->combine(TAG, [WITH])

Not implemented, because I see no use for it.

$obj->date

$obj->delete(NAME, [INDEX]])

Delete the fields with the specified NAME. The deleted fields are returned.

BE WARNED: if no NAME is specified, the delete is interpreted as the deletion of the message in a folder, so Mail::Box::Message::delete() will be called. This may have no negative effect at all...

Calls Mail::Message::Replace::MailHeader::delete()

$obj->destinations

$obj->fold([LENGTH])

Fold all the fields to a certain maximum LENGTH. Implemented by Mail::Message::Replace::MailHeader::fold()

$obj->fold_length([[TAG], LENGTH])

Set the maximum line LENGTH. TAG is ignored. Implemented by Mail::Message::Replace::MailHeader::fold_length()

$obj->from

$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: some fields appear more than once in a header. Calls Mail::Message::Replace::MailHeader::get()

$obj->guessTimestamp

$obj->head([HEAD])

Returns the head of the message, or creates an empty one if none is defined. The HEAD argument, which sets the header, is not available for Mail::Internet, but is there to be compatible with the head method of Mail::Message.

$obj->header([ARRAY])

Optionally reads a header from the ARRAY, and then returns those fields as array-ref nicely folded. Implemented by Mail::Message::Replace::MailHeader::header()

$obj->nrLines

$obj->print_header(FILEHANDLE)

Calls Mail::Message::Head::Complete::print().

$obj->replace(TAG, LINE, [INDEX])

Adds LINES to the header, but removes fields with the same name if they already exist. Calls Mail::Message::Replace::MailHeader::replace()

$obj->sender

$obj->study(FIELDNAME)

$obj->subject

$obj->tidy_headers

No effect anymore (always performed).

$obj->timestamp

$obj->to

The body

$obj->body([ARRAY-OF-LINES|LIST-OF-LINES])

Returns an array of lines, representing the body. With arguments, a new body will be created. In Mail::Internet, the body is not an object but a simple array.

BE WARNED: this overrules the Mail::Message::body() method, which may cause some confusion. Use bodyObject() to get access to that body's data.

$obj->bodyObject([BODY])

Calls Mail::Message::body(), because that body method is overruled by the one which has a Mail::Internet compatible interface.

$obj->contentType

$obj->decoded(OPTIONS)

$obj->encode(OPTIONS)

$obj->isMultipart

$obj->isNested

$obj->parts(['ALL'|'ACTIVE'|'DELETED'|'RECURSE'|FILTER])

$obj->print_body([FILEHANDLE])

Prints the body to the specified FILEHANDLE, which defaults to STDOUT. This calls Mail::Message::Body::print().

$obj->remove_sig([NRLINES])

Remove the signature of a message with a maximum of NRLINES lines, which defaults to 10. The work is done on the decoded body content, by Mail::Message::Body::stripSignature().

$obj->smtpsend(OPTIONS)

This method is calling Mail::Message::send() via smtp, which is implemented in Mail::Transport::SMTP. The implementation is slightly different, so this method is not 100% compliant.

Option  --Default
Debug     <false>
Hello     <helo_domain from Net::Config>
Host      $ENV{SMTPHOSTS} or from Net::Config
MailFrom  $ENV{MAILADDRESS} or $ENV{USER}
Port      25

. Debug => BOOLEAN

. Hello => STRING

. Host => HOSTNAME

Only the first detected HOSTNAME is taken, so differs from the original implementation.

. MailFrom => STRING

Your e-mail address. This simulated Mail::Internet object does not try to create an e-mail address from the sendmail configuration file, because that is generally a bad idea in environments with virtual hosts, as we have now-adays.

. Port => INTEGER

$obj->tidy_body

Removes blank lines from begin and end of the body.

Flags

$obj->deleted([BOOLEAN])

$obj->isDeleted

$obj->isModified

$obj->label(LABEL|PAIRS)

$obj->labels

$obj->labelsToStatus

$obj->modified([BOOLEAN])

$obj->statusToLabels

See "The whole message as text" in Mail::Message::Construct::Text

The whole message as text

$obj->as_mbox_string

Returns the whole message as one string, which can be included in an MBOX folder (while not using Mail::Box::Mbox). Lines in the body which start with From are escaped with an >.

$obj->file

$obj->lines

See "The whole message as text" in Mail::Message::Construct::Text

$obj->printStructure([FILEHANDLE|undef],[INDENT])

See "The whole message as text" in Mail::Message::Construct::Text

$obj->string

See "The whole message as text" in Mail::Message::Construct::Text

The nasty bits

$obj->isa(CLASS)

Mail::Message::Replace::MailInternet->isa(CLASS)

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

Internals

$obj->clonedFrom

Mail::Message::Replace::MailInternet->coerce(MESSAGE)

Coerce (adapt type) of the specified MESSAGE (anything Mail::Message::coerce() accepts) into an Mail::Internet simulating object.

$obj->isDelayed

$obj->readBody(PARSER, HEAD [, BODYTYPE])

$obj->readFromParser(PARSER, [BODYTYPE])

$obj->readHead(PARSER [,CLASS])

See "Internals" in Mail::Message::Construct::Rebuild

$obj->recursiveRebuildPart(PART, OPTIONS)

$obj->storeBody(BODY)

$obj->takeMessageId([STRING])

See "METHODS" in Mail::Message::Construct

Error handling

$obj->AUTOLOAD

$obj->addReport(OBJECT)

$obj->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])

Mail::Message::Replace::MailInternet->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])

$obj->errors

$obj->log([LEVEL [,STRINGS]])

Mail::Message::Replace::MailInternet->log([LEVEL [,STRINGS]])

$obj->logPriority(LEVEL)

Mail::Message::Replace::MailInternet->logPriority(LEVEL)

$obj->logSettings

$obj->notImplemented

$obj->report([LEVEL])

$obj->reportAll([LEVEL])

$obj->shortSize([VALUE])

Mail::Message::Replace::MailInternet->shortSize([VALUE])

See "Error handling" in Mail::Message

$obj->shortString

See "Error handling" in Mail::Message

$obj->trace([LEVEL])

$obj->warnings