12.2.2 AddressList Objects

An AddressList instance has the following methods:

__len__()
Return the number of addresses in the address list.

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

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

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

__sub__(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).

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

Finally, AddressList instances have one public instance variable:

addresslist
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.