Sets up the object. The address must either be set here or when calling parseAddressList(). One or the other.

• return: A new Mail_RFC822 object.
• access: public

• string $address: The address(es) to validate.
• string $default_domain: Default domain/host etc. If not supplied, will be set to localhost.
• boolean $nest_groups: Whether to return the structure with groups nested for easier viewing.
• boolean $validate: Whether to validate atoms. Turn this off if you need to run addresses through before encoding the personal names, for instance.
• $limit

This is a email validating function seperate to the rest

of the class. It simply validates whether an email is of the common internet form: <user>@<domain>. This can be sufficient for most people. Optional stricter mode can be utilised which restricts mailbox characters allowed to alphanumeric, full stop, hyphen and underscore.

• return: False if it fails, an indexed array username/domain if it matches

• string $data: Address to check
• boolean $strict: Optional stricter mode

Function to validate a mailbox, which is: mailbox = addr-spec ; simple address / phrase route-addr ; name and route-addr

• return: Success or failure.
• access: public

• string &$mailbox: The string to check.