Struct salsa::QueryTable

pub struct QueryTable<'me, Q> where
    Q: Query,  { /* fields omitted */ }

Return value from the query method on Database. Gives access to various less common operations on queries.

Implementations

impl<'me, Q> QueryTable<'me, Q> where
    Q: Query,
    Q::Storage: QueryStorageOps<Q>, 

pub fn new(
    db: &'me <Q as QueryDb<'me>>::DynDb,
    storage: &'me Q::Storage
) -> Self

Constructs a new QueryTable.

pub fn get(&self, key: Q::Key) -> Q::Value

Execute the query on a given input. Usually it’s easier to invoke the trait method directly. Note that for variadic queries (those with no inputs, or those with more than one input) the key will be a tuple.

pub fn sweep(&self, strategy: SweepStrategy) where
    Q::Storage: QueryStorageMassOps, 

Remove all values for this query that have not been used in the most recent revision.

pub fn purge(&self) where
    Q::Storage: QueryStorageMassOps, 

Completely clears the storage for this query.

This method breaks internal invariants of salsa, so any further queries might return nonsense results. It is useful only in very specific circumstances – for example, when one wants to observe which values dropped together with the table

Trait Implementations

impl<'d, Q> DebugQueryTable for QueryTable<'_, Q> where
    Q: Query,
    Q::Storage: QueryStorageOps<Q>, 

type Key = Q::Key

Key of this query.

type Value = Q::Value

Value of this query.

fn durability(&self, key: Q::Key) -> Durability

Returns a lower bound on the durability for the given key. This is typically the minimum durability of all values that the query accessed, but we may return a lower durability in some cases.

fn entries<C>(&self) -> C where
    C: FromIterator<TableEntry<Self::Key, Self::Value>>, 

Get the (current) set of the entries in the query table.