Enum imap::extensions::sort::SortCriterion

#[non_exhaustive]
pub enum SortCriterion<'c> {
    Arrival,
    Cc,
    Date,
    From,
    Reverse(&'c SortCriterion<'c>),
    Size,
    Subject,
    To,
}

Message sorting preferences used for Session::sort and Session::uid_sort.

Any sorting criterion that refers to an address (From, To, etc.) sorts according to the “addr-mailbox” of the indicated address. You can find the formal syntax for addr-mailbox in the IMAP spec, and a more detailed discussion of the relevant semantics in RFC 2822. Essentially, the address refers either to the name of the contact or to its local-part (the left part of the email address, before the @).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Arrival

Internal date and time of the message. This differs from the ON criteria in SEARCH, which uses just the internal date.

Cc

IMAP addr-mailbox of the first “Cc” address.

Date

Sent date and time, as described in section 2.2.

From

IMAP addr-mailbox of the first “From” address.

Reverse(&'c SortCriterion<'c>)

Followed by another sort criterion, has the effect of that criterion but in reverse (descending) order.

Size

Size of the message in octets.

Subject

Base subject text.

To

IMAP addr-mailbox of the first “To” address.

Trait Implementations

impl<'c> Clone for SortCriterion<'c>

fn clone(&self) -> SortCriterion<'c>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'c> Debug for SortCriterion<'c>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'c> Display for SortCriterion<'c>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'c> Hash for SortCriterion<'c>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'c> PartialEq<SortCriterion<'c>> for SortCriterion<'c>

fn eq(&self, other: &SortCriterion<'c>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'c> Copy for SortCriterion<'c>

impl<'c> Eq for SortCriterion<'c>

impl<'c> StructuralEq for SortCriterion<'c>

impl<'c> StructuralPartialEq for SortCriterion<'c>