An e-mail address can contain as a phrase an encoded string. Standards describe 2 kinds of encoding:

• Quoted Printable: used to insert hexadecimal value with the = operator.
• Base 64: string encoded in MIME's Base64

Parser already decodes encoded

raw

, the client can use it as is.

The local part of an e-mail address is composer by two kinds of word:

• `Atom is string as is.
• `String is a string surrounded by double-quote to allow white-space.

Local part of e-mail address.

Subset of domain described by RFC5321 which contains 3 kinds of address:

• IPv4: a valid IPv4 address
• IPv6: a valid IPv6 address
• Ext (ldh, value): an extended kind of domain recognized by ldh which valus is value

Parser of IPv4 and IPv6 was done by Ipaddr. An extended kind need to be resolved by the client.

Domain part of e-mail address. A domain integrate kinds from RFC5321 (see addr), a domain described by RFC5322 and a `Literal which is the last best-effort value possible as a domain.

Emile does not resolve domain.

A phrase is a sentence to associate a name with an e-mail address or a group. `Encoded value is not normalized on the charset specifed. The encoded's string is decoded as is only.

A mailbox is an e-mail address. It contains an optionnal name (see phrase), a local-part see {!local

}

and one or more domain(s).

A groyp is a named set of mailbox.

The Emile's type.

Alias of String.compare.

case_insensitive a b maps lowercase_ascii and compare them with String.compare. We do not map UTF8 value.

equal ~compare a b tests if word a and word b are semantically equal. compare specify implementation to compare two string (ie. to be case-sensitive or not).

compare_word ?case_sensitive a b compares word a and word b semantically. From standards, word SHOULD be case-sensitive, the client can notice the behaviour by ?case_sensitive (default is true).

equal_raw a b tests if raw a and raw b are semantically equal. Semantically equal means we compare raw's content, by this way, a Base64 raw could be equal to a Quoted_printable raw if and only if string are equal.

compare_raw a b compares raw a and raw b semantically.

equal_phrase a b tests if phrase a and phrase b are semantically equal. In this case, the comparison is case-insensitive betweem elements in phrase. The order of elements is important.

compare_phrase a b compares phrase a and phrase b semantically.

equal_addr a b tests if addr a and addr b are semantically equal. An IPv4 should be equal with an IPv6 address. Then, for extended kind, we strictly compare kind and value.

compare_addr a b compares addr a and addr b, we priotize IPv6, IPv4 and finally Ext.

equal_addr a b tests if domain a and domain b are semantically equal. We do not resolve domain, a `Domain could be semantically equal to another `Domain if they point to the same IPv4/IPv6.

comapre_domain a b compares domain a and domain b, we prioritize `Domain, `Literal and finally `Addr. The comparison between two `Literal and between part of `Domain are case-insensitive.

equal_domains a b apply equal_domain to ordered domains (see compare_domain) between a and b.

compare_domains a b compares ordered list of domain a and ordered list of domain b.

equal_local ?case_sensitive a b tests if local a and local b are semantically equal. Standards notices local-prt SHOULD be case-sensitive, the client can choose this behaviour with case_sensitive.

compare_local ?case_sensitive a b compares local a and local b semantically. The user can decide if the comparison is case-sensitive or not (with case_sensitive).

equal_mailbox ?case_sensitive a b tests if mailbox a and mailbox b are semantically equal. The user can define if the local-part need to be case-sensitive or not (by case_sensitive). If a xor b has a name, we cosider a = b if we have the same local-part and same domain(s).

compare ?case_sensitive a b compares mailbox a and mailbxo b semantically. We prioritize local-part, domain-part and finally optionnal name.

comapre_group a b compares group a and group b. We compare the group name first and compare ordered mailboxes list then.

equal_group a b tests if group a and group b are semantically equal. We compare first group name and ordered mailboxes list then.

equal a b tests semantically t a and t b.

compare a b compares t a and t b.

A structurally equal function on t.