Struct Collection 

pub struct Collection<In, Ix, S = DefaultStore<In>> { /* private fields */ }

A collection of items, with an index that is automatically kept up-to-date.

Implementations

impl<In, Ix> Collection<In, Ix>

pub fn new(ix: Ix) -> Self

where In: 'static, Ix: Index<In>, DefaultStore<In>: Store<In>,

Create an empty collection.

impl<In, Ix, S: Default> Collection<In, Ix, S>

pub fn new_with_empty_store(ix: Ix) -> Self

Create an empty collection.

impl<In, Ix, S> Collection<In, Ix, S>

pub fn new_with_store(store: S, ix: Ix) -> Self

Create an empty collection with a custom store.

impl<In, Ix, S> Collection<In, Ix, S>

where In: 'static, Ix: Index<In>, S: Store<In>,

pub fn get_by_key(&self, key: Key) -> Option<&In>

Lookup an item in the collection by its key.

pub fn insert(&mut self, value: In) -> Key

Insert a new item into the collection.

pub fn iter(&self) -> impl IntoIterator<Item = (Key, &In)>

Iterate over all items in the collection.

pub fn update_by_key_mut<F>(&mut self, key: Key, f: F)

where F: FnOnce(&mut Option<In>),

Mutate (or alter the presence of) the item in the collection.

pub fn update_by_key<F>(&mut self, key: Key, f: F)

where F: FnOnce(Option<&In>) -> In,

Update the item in the collection.

pub fn adjust_by_key_mut<F>(&mut self, key: Key, f: F)

where F: FnOnce(&mut In),

Mutate the item in the collection, if it exists.

pub fn adjust_by_key<F>(&mut self, key: Key, f: F)

where F: FnOnce(&In) -> In,

Adjust the item in the collection, if it exists.

pub fn delete_by_key(&mut self, key: Key) -> Option<In>

Remove an item from the collection, returning it if it exists.

pub fn query<Res>(&self, f: impl FnOnce(&Ix) -> Res) -> Res::Resolved<&In>

where Res: QueryResult,

Query the collection using its index(es).

pub fn delete<Res>(&mut self, f: impl FnOnce(&Ix) -> Res) -> usize

where Res: QueryResult,

pub fn update<Res, F>( &mut self, f: impl FnOnce(&Ix) -> Res, update_fn: impl Fn(&In) -> In, ) -> Res::Resolved<()>

where Res: QueryResultDistinct,

pub fn take<Res>(&mut self, f: impl FnOnce(&Ix) -> Res) -> Res::Resolved<In>

where Res: QueryResultDistinct,

pub fn len(&self) -> usize

Number of items in the collection.

pub fn is_empty(&self) -> bool