NAME

overload: +0

overload: <=>

overload: bool

overload: cmp

See "Constructors" in Mail::Message::Field

METHODS

Constructors

$obj->clone

Mail::Message::Field::Fast->new(DATA)

The constructor of this object does not follow the usual practise within the Mail::Box suite: it does not use the constructor Mail::Reporter::new(). Therefor it has no logging or tracing facilities.

The method can be used in one of the following ways:

new LINE

Pass a LINE as it could be found in a file: a (possibly folded) line which is terminated by a new-line.
new NAME, (BODY|OBJECTS), [ATTRIBUTES]

A set of values which shape the line.

Create a new header field object. Specify the whole LINE at once, and it will be split-up for you. I case you already have the parts of the header line, you may specify them separately as NAME and BODY.

In case you specify a single OBJECT, or a reference to an array of OBJECTS, these objects are processed to become suitable to fill a field, usually by simple strification. When you specify one or more Mail::Address objects, these are transformed into a string using their format method. You may also add one Mail::Message::Field, whose body is taken. In case of an array, the elements are joined into one string with a comma.

ATTRIBUTES can be exactly one string which may contain multiple attributes at once, quoted and formatted as required in RFC2822. As alternative, list of key-value pairs can be used. In this case, the values will get quoted if needed and everything formatted as the protocol demands.

Option--Defined in     --Default
log     Mail::Reporter   <disabled>
trace   Mail::Reporter   <disabled>

. log => LEVEL

. trace => LEVEL

example:

my $mime = Mail::Message::Field->new(
 'Content-Type: text/plain; charset=US-ASCII');

my $mime = Mail::Message::Field->new(
 'Content-Type' => 'text/plain; charset=US-ASCII');

my $mime = Mail::Message::Field->new(
 'Content-Type' => 'text/plain', 'charset=US-ASCII');

my $mime = Mail::Message::Field->new(
 'Content-Type' => 'text/plain', charset => 'Latin1');

my $mime = Mail::Message::Field->new(
 To => Mail::Address->new('My', 'me@example.com');

my $mime = Mail::Message::Field->new(
 Cc => [ Mail::Address->new('You', 'you@example.com')
       , Mail::Address->new('His', 'he@example.com')
       ]);

But in practice, you can simply call

my $head = Mail::Message::Head->new;
$head->add( 'Content-Type' => 'text/plain'
          , charset => 'utf8');

which implicitly calls this constructor (when needed). You can specify the same things for Mail::Message::Head::Complete::add() as this new accepts.

The field

$obj->isStructured

Mail::Message::Field::Fast->isStructured

$obj->length

$obj->nrLines

$obj->print([FILEHANDLE])

$obj->size

$obj->string([WRAP])

$obj->toDisclose

See "Access to the name" in Mail::Message::Field

Access to the name

$obj->Name

$obj->name

See "Access to the name" in Mail::Message::Field

$obj->wellformedName([STRING])

See "Access to the name" in Mail::Message::Field

Access to the body

$obj->body

$obj->folded

$obj->foldedBody([BODY])

$obj->stripCFWS([STRING])

Mail::Message::Field::Fast->stripCFWS([STRING])

$obj->unfoldedBody([BODY, [WRAP]])

See "Access to the content" in Mail::Message::Field

Access to the content

$obj->addresses

$obj->attribute(NAME [, VALUE])

See "Access to the content" in Mail::Message::Field

$obj->attributes

See "Access to the content" in Mail::Message::Field

$obj->comment([STRING])

See "Access to the content" in Mail::Message::Field

$obj->study

See "Access to the content" in Mail::Message::Field

$obj->toDate([TIME])

Mail::Message::Field::Fast->toDate([TIME])

See "Access to the content" in Mail::Message::Field

$obj->toInt

See "Access to the content" in Mail::Message::Field

Other methods

$obj->dateToTimestamp(STRING)

Mail::Message::Field::Fast->dateToTimestamp(STRING)

See "Other methods" in Mail::Message::Field

Internals

$obj->consume(LINE | (NAME,BODY|OBJECTS))

$obj->defaultWrapLength([LENGTH])

$obj->fold(NAME, BODY, [MAXCHARS])

Mail::Message::Field::Fast->fold(NAME, BODY, [MAXCHARS])

$obj->setWrapLength([LENGTH])

$obj->stringifyData(STRING|ARRAY|OBJECTS)

$obj->unfold(STRING)

Error handling

$obj->AUTOLOAD

$obj->addReport(OBJECT)

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

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

$obj->errors

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

Mail::Message::Field::Fast->log([LEVEL [,STRINGS]])

$obj->logPriority(LEVEL)

Mail::Message::Field::Fast->logPriority(LEVEL)

$obj->logSettings

$obj->notImplemented

$obj->report([LEVEL])

$obj->reportAll([LEVEL])

$obj->trace([LEVEL])

$obj->warnings