NAME

overload: +0

overload: <=>

overload: bool

overload: cmp

See Constructors in the Mail::Message::Field manpage

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     L<Mail::Reporter>  <disabled>
 trace   L<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 the Mail::Message::Field manpage

Access to the name

$obj->Name

$obj->name

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

$obj->wellformedName([STRING])

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

Access to the body

$obj->body

See Access to the body in the Mail::Message::Field manpage

$obj->folded

See Access to the body in the Mail::Message::Field manpage

$obj->foldedBody([BODY])

See Access to the body in the Mail::Message::Field manpage

$obj->stripCFWS([STRING])

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

See Access to the body in the Mail::Message::Field manpage

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

See Access to the body in the Mail::Message::Field manpage

Access to the content

$obj->addresses

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

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

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

$obj->attributes

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

$obj->comment([STRING])

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

$obj->study

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

$obj->toDate([TIME])

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

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

$obj->toInt

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

Other methods

$obj->dateToTimestamp(STRING)

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

See Other methods in the Mail::Message::Field manpage

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