Struct holochain_integrity_types::chain::ChainFilter
source · [−]pub struct ChainFilter<H: Eq + Ord + Hash = ActionHash> {
pub chain_top: H,
pub filters: ChainFilters<H>,
pub include_cached_entries: bool,
}
Expand description
Filter source chain items.
Starting from some chain position given as an ActionHash
the chain is walked backwards to genesis.
The filter can stop early by specifying the number of
chain items to take and / or an ActionHash
to consume until.
Fields
chain_top: H
The starting position of the filter.
filters: ChainFilters<H>
The filters that have been applied.
Defaults to ChainFilters::ToGenesis
.
include_cached_entries: bool
Should the query return any entries that are cached at the agent activity to save network hops.
Implementations
sourceimpl<H: Eq + Ord + Hash> ChainFilter<H>
impl<H: Eq + Ord + Hash> ChainFilter<H>
sourcepub fn new(chain_top: H) -> Self
pub fn new(chain_top: H) -> Self
Create a new filter using this ActionHash
as
the starting position and walking the chain
towards the genesis Action
.
sourcepub fn take(self, n: u32) -> Self
pub fn take(self, n: u32) -> Self
Take up to n
actions including the starting position.
This may return less then n
actions.
sourcepub fn include_cached_entries(self) -> Self
pub fn include_cached_entries(self) -> Self
Set this filter to include any cached entries at the agent activity authority.
sourcepub fn until(self, action_hash: H) -> Self
pub fn until(self, action_hash: H) -> Self
Take all actions until this action hash is found.
Note that all actions specified as until
hashes must be
found so this filter can produce deterministic results.
It is invalid to specify an until hash that is on a different
fork then the starting position.
Trait Implementations
sourceimpl<H: Clone + Eq + Ord + Hash> Clone for ChainFilter<H>
impl<H: Clone + Eq + Ord + Hash> Clone for ChainFilter<H>
sourcefn clone(&self) -> ChainFilter<H>
fn clone(&self) -> ChainFilter<H>
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresourceimpl<'de, H: Eq + Ord + Hash> Deserialize<'de> for ChainFilter<H>where
H: Deserialize<'de>,
impl<'de, H: Eq + Ord + Hash> Deserialize<'de> for ChainFilter<H>where
H: Deserialize<'de>,
sourcefn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
sourceimpl<H: PartialEq + Eq + Ord + Hash> PartialEq<ChainFilter<H>> for ChainFilter<H>
impl<H: PartialEq + Eq + Ord + Hash> PartialEq<ChainFilter<H>> for ChainFilter<H>
sourcefn eq(&self, other: &ChainFilter<H>) -> bool
fn eq(&self, other: &ChainFilter<H>) -> bool
sourceimpl TryFrom<&ChainFilter<HoloHash<Action>>> for SerializedBytes
impl TryFrom<&ChainFilter<HoloHash<Action>>> for SerializedBytes
type Error = SerializedBytesError
type Error = SerializedBytesError
sourcefn try_from(t: &ChainFilter) -> Result<SerializedBytes, SerializedBytesError>
fn try_from(t: &ChainFilter) -> Result<SerializedBytes, SerializedBytesError>
sourceimpl TryFrom<ChainFilter<HoloHash<Action>>> for SerializedBytes
impl TryFrom<ChainFilter<HoloHash<Action>>> for SerializedBytes
type Error = SerializedBytesError
type Error = SerializedBytesError
sourcefn try_from(t: ChainFilter) -> Result<SerializedBytes, SerializedBytesError>
fn try_from(t: ChainFilter) -> Result<SerializedBytes, SerializedBytesError>
sourceimpl TryFrom<SerializedBytes> for ChainFilter
impl TryFrom<SerializedBytes> for ChainFilter
type Error = SerializedBytesError
type Error = SerializedBytesError
sourcefn try_from(sb: SerializedBytes) -> Result<ChainFilter, SerializedBytesError>
fn try_from(sb: SerializedBytes) -> Result<ChainFilter, SerializedBytesError>
impl<H: Eq + Eq + Ord + Hash> Eq for ChainFilter<H>
impl<H: Eq + Ord + Hash> StructuralEq for ChainFilter<H>
impl<H: Eq + Ord + Hash> StructuralPartialEq for ChainFilter<H>
Auto Trait Implementations
impl<H> RefUnwindSafe for ChainFilter<H>where
H: RefUnwindSafe,
impl<H> Send for ChainFilter<H>where
H: Send,
impl<H> Sync for ChainFilter<H>where
H: Sync,
impl<H> Unpin for ChainFilter<H>where
H: Unpin,
impl<H> UnwindSafe for ChainFilter<H>where
H: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
sourceimpl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
sourcefn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.