SYNOPSIS

 !! UNDER CONSTRUCTION
 !! The details of this module are NOT FINISHED yet
 !! Most parts are already usable, however.  With care!

 # Getting to understand the complexity of a header field ...

 my $fast = $msg->head->get('subject');
 my $full = Mail::Message::Field::Full->from($fast);

 my $full = $msg->head->get('subject')->study;  # same
 my $full = $msg->head->study('subject');       # same
 my $full = $msg->study('subject');             # same

 # ... or build a complex header field yourself

 my $f = Mail::Message::Field::Full->new('To');
 my $f = Mail::Message::Field::Full->new('Subject: hi!');
 my $f = Mail::Message::Field::Full->new(Subject => 'hi!');

See SYNOPSIS in Mail::Message::Field

DESCRIPTION

This is the full implementation of a header field: it has full understanding of all predefined header fields. These objects will be quite slow, because header fields can be very complex. Of course, this class delivers the optimal result, but for a quite large penalty in performance and memory consumption. Are you willing to accept?

This class supports the common header description from RFC2822 (formerly RFC822), the extensions with respect to character set encodings as specified in RFC2047, and the extensions on language specification and long parameter wrapping from RFC2231. If you do not need the latter two, then the Mail::Message::Field::Fast and Mail::Message::Field::Flex are enough for your application.

See DESCRIPTION in Mail::Message::Field

DETAILS

Field syntax

See Field syntax in Mail::Message::Field

Folding fields

See Folding fields in Mail::Message::Field

Structured fields

See Structured fields in Mail::Message::Field

Comments in fields

See Comments in fields in Mail::Message::Field

Getting a field

See Getting a field in Mail::Message::Field

Using get() field

See Using get() field in Mail::Message::Field

Using study() field

See Using study() field in Mail::Message::Field

Using resent groups

See Using resent groups in Mail::Message::Field

The field's data

See The field's data in Mail::Message::Field

Access to the field

See Access to the field in Mail::Message::Field

Using simplified field access

See Using simplified field access in Mail::Message::Field

Specifying field data

See Specifying field data in Mail::Message::Field

Field class implementation

See Field class implementation in Mail::Message::Field