Struct salsa::QueryTableMut

pub struct QueryTableMut<'me, DB, Q> where
    DB: GetQueryTable<Q>,
    Q: Query<DB> + 'me,  { /* fields omitted */ }

Return value from the query_mut method on Database. Gives access to the set method, notably, that is used to set the value of an input query.

Methods

impl<'me, DB, Q> QueryTableMut<'me, DB, Q> where
    DB: GetQueryTable<Q>,
    Q: Query<DB> + 'me, 

pub fn new(db: &'me DB, storage: &'me Q::Storage) -> Self

Constructs a new QueryTableMut.

impl<'_, DB, Q> QueryTableMut<'_, DB, Q> where
    DB: GetQueryTable<Q>,
    Q: Query<DB>, 

pub fn set(&self, key: Q::Key, value: Q::Value) where
    Q::Storage: InputQueryStorageOps<DB, Q>, 

Assign a value to an "input query". Must be used outside of an active query computation.

If you are using snapshot, see the notes on blocking and cancellation on the query_mut method.

pub fn set_with_durability(
    &self,
    key: Q::Key,
    value: Q::Value,
    durability: Durability
) where
    Q::Storage: InputQueryStorageOps<DB, Q>, 

Assign a value to an "input query", with the additional promise that this value will never change. Must be used outside of an active query computation.

If you are using snapshot, see the notes on blocking and cancellation on the query_mut method.

pub fn set_lru_capacity(&self, cap: usize) where
    Q::Storage: LruQueryStorageOps, 

Sets the size of LRU cache of values for this query table.

That is, at most cap values will be preset in the table at the same time. This helps with keeping maximum memory usage under control, at the cost of potential extra recalculations of evicted values.

If cap is zero, all values are preserved, this is the default.

pub fn invalidate(&self, key: &Q::Key) where
    Q::Storage: DerivedQueryStorageOps<DB, Q>, 

Marks the computed value as outdated.

This causes salsa to re-execute the query function on the next access to the query, even if all dependencies are up to date.

This is most commonly used for invaliding on-demand inputs; see the Salsa Book for more information.