Struct salsa::Durability

pub struct Durability(_);

Describes how likely a value is to change -- how "durable" it is. By default, inputs have Durability::LOW and interned values have Durability::HIGH. But inputs can be explicitly set with other durabilities.

We use durabilities to optimize the work of "revalidating" a query after some input has changed. Ordinarily, in a new revision, queries have to trace all their inputs back to the base inputs to determine if any of those inputs have changed. But if we know that the only changes were to inputs of low durability (the common case), and we know that the query only used inputs of medium durability or higher, then we can skip that enumeration.

Typically, one assigns low durabilites to inputs that the user is frequently editing. Medium or high durabilities are used for configuration, the source from library crates, or other things that are unlikely to be edited.

Implementations

impl Durability

pub const LOW: Durability

Low durability: things that change frequently.

Example: part of the crate being edited

pub const MEDIUM: Durability

Medium durability: things that change sometimes, but rarely.

Example: a Cargo.toml file

pub const HIGH: Durability

High durability: things that are not expected to change under common usage.

Example: the standard library or something from crates.io

Trait Implementations

impl Clone for Durability

fn clone(&self) -> Durability

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Durability

impl Debug for Durability

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

Formats the value using the given formatter.

impl Eq for Durability

impl Ord for Durability

fn cmp(&self, other: &Durability) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<Durability> for Durability

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

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

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

This method tests for !=.

impl PartialOrd<Durability> for Durability

fn partial_cmp(&self, other: &Durability) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Durability) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Durability) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Durability) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Durability) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for Durability

impl StructuralPartialEq for Durability