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::Addresses->from(FIELD, OPTIONS)

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

Mail::Message::Field::Addresses->new

Option    --Defined in     --Default
attributes  Mail::Message::Field::Structured  <ignored>
charset     Mail::Message::Field::Full  undef
datum       Mail::Message::Field::Structured  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'

. attributes => ATTRS

. charset => STRING

. datum => STRING

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

. force => BOOLEAN

. language => STRING

. log => LEVEL

. trace => LEVEL

The field

$obj->isStructured

Mail::Message::Field::Addresses->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::Addresses->stripCFWS([STRING])

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

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

Access to the content

$obj->addAddress([ADDRESS], OPTIONS)

Add an ADDRESS to the field. The addresses are organized in groups. If no group is specified, the default group is taken to store the address in. If no ADDRESS is specified, the option must be sufficient to create a Mail::Message::Field::Address from. See the OPTIONS of Mail::Message::Field::Address::new().

Option--Default
group   ''

. group => STRING

$obj->addAttribute(...)

Attributes are not supported for address fields.

$obj->addGroup(GROUP|OPTIONS)

Add a group of addresses to this field. A GROUP can be specified, which is a Mail::Message::Field::AddrGroup object, or one is created for you using the OPTIONS. The group is returned.

Option--Default
name    ''

. name => STRING

$obj->addresses

Returns a list with all addresses defined in any group of addresses: all addresses which are specified on the line. The addresses are Mail::Message::Field::Address objects.

example:

my @addr = $field->addresses;

$obj->attribute(OBJECT|(STRING, OPTIONS)|(NAME,VALUE,OPTIONS))

$obj->attributes

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

$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::Addresses->createComment(STRING, OPTIONS)

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

$obj->createPhrase(STRING, OPTIONS)

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

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

$obj->group(NAME)

Returns the group of addresses with the specified NAME, or undef if it does not exist. If NAME is undef, then the default groep is returned.

$obj->groupNames

Returns a list with all group names which are defined.

$obj->groups

Returns all address groups which are defined in this field. Each element is a Mail::Message::Field::AddrGroup object.

$obj->study

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

$obj->toDate([TIME])

Mail::Message::Field::Addresses->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::Addresses->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::Addresses->decode(STRING, OPTIONS)

$obj->defaultWrapLength([LENGTH])

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

$obj->encode(STRING, OPTIONS)

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

Mail::Message::Field::Addresses->fold(NAME, BODY, [MAXCHARS])

$obj->setWrapLength([LENGTH])

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

$obj->unfold(STRING)

Parsing

$obj->consumeAddress(STRING, OPTIONS)

Try to destilate address information from the STRING. Returned are an address object and the left-over string. If no address was found, the first returned value is undef.

$obj->consumeComment(STRING)

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

$obj->consumeDomain(STRING)

Try to get a valid domain representation from STRING. Returned are the domain string as found (or undef) and the rest of the string.

$obj->consumeDotAtom(STRING)

$obj->consumePhrase(STRING)

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

See "Parsing" in Mail::Message::Field::Structured

$obj->datum([VALUE])

$obj->parse(STRING)

$obj->produceBody

Error handling

$obj->AUTOLOAD

$obj->addReport(OBJECT)

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

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

$obj->errors

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

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

$obj->logPriority(LEVEL)

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

$obj->logSettings

$obj->notImplemented

$obj->report([LEVEL])

$obj->reportAll([LEVEL])

$obj->trace([LEVEL])

$obj->warnings