12.11.2 AddressList Objects

An AddressList instance has the following methods:

Return the number of addresses in the address list.

Return a canonicalized string representation of the address list. Addresses are rendered in "name" <host@domain> form, comma-separated.

Return a new AddressList instance that contains all addresses in both AddressList operands, with duplicates removed (set union).

In-place version of __add__(); turns this AddressList instance into the union of itself and the right-hand instance, alist.

Return a new AddressList instance that contains every address in the left-hand AddressList operand that is not present in the right-hand address operand (set difference).

In-place version of __sub__(), removing addresses in this list which are also in alist.

Finally, AddressList instances have one public instance variable:

A list of tuple string pairs, one per address. In each member, the first is the canonicalized name part, the second is the actual route-address ("@"-separated username-host.domain pair).

See About this document... for information on suggesting changes.