Enum imap::types::Deleted

pub enum Deleted {
    Expunged(Vec<Seq>),
    Vanished(Vec<RangeInclusive<Uid>>),
}

An enum representing message sequence numbers or UID sequence sets returned in response to a EXPUNGE command.

The EXPUNGE command may return several EXPUNGE responses referencing message sequence numbers, or it may return a VANISHED response referencing multiple UID values in a sequence set if the client has enabled QRESYNC.

Deleted implements some iterators to make it easy to use. If the caller knows that they should be receiving an EXPUNGE or VANISHED response, then they can use seqs() to get an iterator over EXPUNGE message sequence numbers, or uids() to get an iterator over the VANISHED UIDs. As a convenience Deleted also implents IntoIterator which just returns an iterator over whatever is contained within.

Examples

// Iterate over whatever is returned
if let Ok(deleted) = session.expunge() {
    for id in &deleted {
        // Do something with id
    }
}

// Expect a VANISHED response with UIDs
if let Ok(deleted) = session.expunge() {
    for uid in deleted.uids() {
        // Do something with uid
    }
}

Variants

Expunged(Vec<Seq>)

Message sequence numbers given in an EXPUNGE response.

Vanished(Vec<RangeInclusive<Uid>>)

Message UIDs given in a VANISHED response.

Implementations

impl Deleted

pub fn from_expunged(v: Vec<u32>) -> Self

Construct a new Deleted value from a vector of message sequence numbers returned in one or more EXPUNGE responses.

pub fn from_vanished(v: Vec<RangeInclusive<u32>>) -> Self

Construct a new Deleted value from a sequence-set of UIDs returned in a VANISHED response

pub fn seqs(&self) -> impl Iterator<Item = Seq> + '_

Return an iterator over message sequence numbers from an EXPUNGE response. If the client is expecting sequence numbers this function can be used to ensure only sequence numbers returned in an EXPUNGE response are processed.

pub fn uids(&self) -> impl Iterator<Item = Uid> + '_

Return an iterator over UIDs returned in a VANISHED response. If the client is expecting UIDs this function can be used to ensure only UIDs are processed.

pub fn is_empty(&self) -> bool

Return if the set is empty

Trait Implementations

impl Clone for Deleted

fn clone(&self) -> Deleted

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Deleted

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

Formats the value using the given formatter.

impl<'a> IntoIterator for &'a Deleted

type Item = u32

The type of the elements being iterated over.

type IntoIter = Box<dyn Iterator<Item = u32> + 'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.