Mail::Message::Field::Full 2.073

Mail::Message::Field::Full is a Perl module that can construct one smart line in a message header.

INHERITANCE

Mail::Message::Field::Full
is a Mail::Message::Field
is a Mail::Reporter

Mail::Message::Field::Full is extended by
Mail::Message::Field::Structured
Mail::Message::Field::Unstructured

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->get(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!);

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.