Perl in a Nutshell, 2nd Edition

Name

new

Synopsis

$mail = new Mail::Internet ([arg], [options])

Creates a new Mail::Internet object. arg is optional and may be either a file descriptor (a reference to a glob) or a reference to an array. If present, the new object is initialized with headers either from the array or read from the file descriptor. options is a list of options in the form of key/value pairs. Possible options are:

Header

Mail::Internet should not attempt to read a mail header from arg, if it was specified. Value is a Mail::Header object.

Body

Mail::Internet should attempt to read the body from arg, if it was specified. Value is a reference to an array that contains the lines of the message body.

Modify

Reformats the headers if true. Mail::Header option.

MailFrom

Specifies behavior for headers in the form "From “. Mail::Header option. Possible values are:

IGNORE

Ignores and discards the headers

ERROR

Calls die

COERCE

Renames headers to Mail-From

KEEP

Keeps headers as they are

FoldLength

Value is default line length for folding headers. Mail::Header option.