Enum KvOutcome 

#[non_exhaustive]
pub enum KvOutcome {
    Value(Option<KvEntry>),
    Written,
    Committed {
        version: u64,
    },
    Deleted(bool),
    DeletedMany(usize),
    Page(KvPage),
    Namespaces(Vec<KvNamespaceInfo>),
    NotModified,
    Metadata(Option<KvMetadata>),
    Versioned {
        version: u64,
    },
    Leased {
        lease_token: u64,
        granted_ttl_micros: u64,
    },
    Released(bool),
}

The successful outcome of a KV command, shaped per op.

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.

Value(Option<KvEntry>)

get: the live entry, or None when absent or expired.

Written

set: the write was applied.

Committed

cas: the compare-and-swap applied. Carries the entry’s new version, so the caller can chain a further conditional write without a re-read.

Fields

version: u64

Deleted(bool)

delete: true when a live entry was removed, false when none existed.

DeletedMany(usize)

delete_many: the number of entries removed by a filtered bulk delete.

Page(KvPage)

scan: one page of entries.

Namespaces(Vec<KvNamespaceInfo>)

namespaces: every namespace holding at least one entry for the caller with its entry count, sorted by name.

NotModified

get with if_none_match: the live version matched, so the body is unchanged and not transferred (a conditional-GET hit).

Metadata(Option<KvMetadata>)

exists: the key’s metadata, or None when absent or expired.

Versioned

expire / patch: applied, carrying the entry’s version. expire leaves the version unchanged, patch bumps it.

Fields

version: u64

Leased

lease: the lease was granted, carrying the fencing token and the granted TTL (which the store may shorten from the request).

Fields

lease_token: u64

granted_ttl_micros: u64

Released(bool)

release: true when a held lease was released, false when none was held (idempotent release).

Trait Implementations

impl Clone for KvOutcome

fn clone(&self) -> KvOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KvOutcome

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KvOutcome

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for KvOutcome

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.