Struct SelectOptions 

#[non_exhaustive]
pub struct SelectOptions {
    pub condstore: bool,
    pub qresync: Option<QresyncParams>,
}

Options for SELECT/EXAMINE commands beyond the basic mailbox name (RFC 3501 Sections 6.3.1/6.3.2, RFC 7162 Sections 3.1.8 and 3.2.5.2).

Used with [ImapConnection::select_with] and [ImapConnection::examine_with] to request CONDSTORE or QRESYNC extensions without requiring separate method variants for each combination.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

condstore: bool

Enable CONDSTORE per-message mod-sequence tracking (RFC 7162 Section 3.1.1).

When true, the server includes HIGHESTMODSEQ in the OK response and tracks per-message MODSEQ values for the selected mailbox. Requires the CONDSTORE or QRESYNC capability (RFC 7162 Section 3.1).

qresync: Option<QresyncParams>

QRESYNC parameters for efficient delta sync (RFC 7162 Section 3.2.5.2).

Provides the server with the client’s last known UIDVALIDITY and MODSEQ so it can send VANISHED (EARLIER) and FETCH (FLAGS) for changed messages instead of a full resync. Requires the QRESYNC capability to have been enabled first (RFC 7162 Section 3.2.5).

Implementations

impl SelectOptions

pub fn condstore() -> Self

Create options with CONDSTORE enabled (RFC 7162 Section 3.1.1).

pub fn qresync(params: QresyncParams) -> Self

Create options with QRESYNC parameters (RFC 7162 Section 3.2.5.2).

Trait Implementations

impl Clone for SelectOptions

fn clone(&self) -> SelectOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SelectOptions

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

Formats the value using the given formatter.

impl Default for SelectOptions

fn default() -> SelectOptions

Returns the “default value” for a type.

impl Hash for SelectOptions

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 PartialEq for SelectOptions

fn eq(&self, other: &SelectOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for SelectOptions

impl StructuralPartialEq for SelectOptions