NAME

overload: +0

overload: <=>

overload: bool

overload: cmp

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

overload: stringification

METHODS

Constructors

$obj->clone

See Mail::Message::Field/"Constructors"

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

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

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   Mail::Message::Field::Full  undef
 encoding  Mail::Message::Field::Full  'q'
 force     Mail::Message::Field::Full  false
 language  Mail::Message::Field::Full  undef
 log       Mail::Reporter   'WARNINGS'
 trace     Mail::Reporter   '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 Mail::Message::Field/"Access to the name"

Access to the name

$obj->Name

$obj->name

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

$obj->wellformedName([STRING])

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

Access to the body

$obj->body

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

$obj->decodedBody(OPTIONS)

$obj->folded

$obj->foldedBody([BODY])

$obj->stripCFWS([STRING])

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

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

Access to the content

$obj->addresses

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

$obj->attributes

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

$obj->beautify

$obj->comment([STRING])

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

$obj->createComment(STRING, OPTIONS)

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

$obj->createPhrase(STRING, OPTIONS)

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

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

$obj->study

$obj->toDate([TIME])

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

$obj->toInt

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

Other methods

$obj->dateToTimestamp(STRING)

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

Internals

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

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

$obj->decode(STRING, OPTIONS)

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

$obj->defaultWrapLength([LENGTH])

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

$obj->encode(STRING, OPTIONS)

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

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

$obj->produceBody

Error handling

$obj->AUTOLOAD

$obj->addReport(OBJECT)

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

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

$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