NAME

overload: +0

overload: <=>

overload: bool

overload: cmp

See "OVERLOADED" in Mail::Message::Field::Full

overload: stringification

METHODS

Constructors

$obj->clone

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

Mail::Message::Field::Unstructured->from(FIELD, OPTIONS)

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

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

When the DATA is specified as single line, the content part is considered to be correcly (character) encoded and escaped. Typically, it is a line as read from file. The folding of the line is kept as is.

In case more than one argument is provided, the second is considered the BODY. Attributes and other special things are not defined for unstructured fields, and therefore not valid options. The BODY can be a single string, a single OBJECT, or an array of OBJECTS. The objects are stringified (into a comma separated list). Each BODY element is interpreted with the specified encoding.

When the BODY is empty, the construction of the object fails: undef is returned.

Option    Defined in       Default      
charset   L<Mail::Message::Field::Full>  undef        
encoding  L<Mail::Message::Field::Full>  C<'q'>       
force     L<Mail::Message::Field::Full>  false        
language  L<Mail::Message::Field::Full>  undef        
log       L<Mail::Reporter>  C<'WARNINGS'>
trace     L<Mail::Reporter>  C<'WARNINGS'>

. charset STRING

. encoding 'q'|'Q'|'b'|'B'

. force BOOLEAN

. language STRING

. log LEVEL

. trace LEVEL

Example:

my $s = Mail::Message::Field::Unstructured->new('Comment', 'Hi!');

# Use autodetect
my $s = Mail::Message::Field::Full->new('Comment', 'Hi!');
my $s = Mail::Message::Field::Full->new('Comment: Hi!');

The field

$obj->isStructured

Mail::Message::Field::Unstructured->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

See "Access to the body" in Mail::Message::Field::Full

$obj->decodedBody(OPTIONS)

$obj->folded

$obj->foldedBody([BODY])

$obj->stripCFWS([STRING])

Mail::Message::Field::Unstructured->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->beautify

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

$obj->comment([STRING])

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

$obj->createComment(STRING, OPTIONS)

Mail::Message::Field::Unstructured->createComment(STRING, OPTIONS)

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

$obj->createPhrase(STRING, OPTIONS)

Mail::Message::Field::Unstructured->createPhrase(STRING, OPTIONS)

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

$obj->study

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

$obj->toDate([TIME])

Mail::Message::Field::Unstructured->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::Unstructured->dateToTimestamp(STRING)

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

Internals

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

See "Internals" in Mail::Message::Field::Full

$obj->decode(STRING, OPTIONS)

Mail::Message::Field::Unstructured->decode(STRING, OPTIONS)

$obj->defaultWrapLength([LENGTH])

See "Internals" in Mail::Message::Field::Full

$obj->encode(STRING, OPTIONS)

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

$obj->setWrapLength([LENGTH])

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

$obj->unfold(STRING)

Parsing

$obj->consumeComment(STRING)

Mail::Message::Field::Unstructured->consumeComment(STRING)

$obj->consumeDotAtom(STRING)

$obj->consumePhrase(STRING)

Mail::Message::Field::Unstructured->consumePhrase(STRING)

$obj->parse(STRING)

Error handling

$obj->AUTOLOAD

$obj->defaultTrace([LEVEL, [LEVEL])

Mail::Message::Field::Unstructured->defaultTrace([LEVEL, [LEVEL])

$obj->errors

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

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

$obj->logPriority(LEVEL)

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

$obj->logSettings

$obj->notImplemented

$obj->report([LEVEL])

$obj->reportAll([LEVEL])

$obj->trace([LEVEL])

$obj->warnings