Struct HashMapStore 

pub struct HashMapStore<A: Agent> { /* private fields */ }

Hash-map-based agent store.

Backed by hashbrown::HashMap for O(1) average-case insert, remove, and lookup. Iteration order is not guaranteed and must not be used as a reproducibility contract.

This is the default store for most simulations.

Implementations

impl<A: Agent> HashMapStore<A>

pub fn new() -> Self

Create an empty HashMapStore.

Trait Implementations

impl<A: Agent> AgentStore<A> for HashMapStore<A>

fn get(&self, id: AgentId) -> Option<Ref<'_, A>>

Borrow an agent immutably by ID.

fn get_mut(&self, id: AgentId) -> Option<RefMut<'_, A>>

Borrow an agent mutably by ID.

fn insert(&mut self, agent: A)

Insert an agent into the store.

fn remove(&mut self, id: AgentId) -> Option<A>

Remove and return an agent by ID, or None if not found.

fn iter_ids(&self) -> Vec<AgentId>

Collect all agent IDs into a new Vec.

fn iter_ids_into(&self, buf: &mut Vec<AgentId>)

Append all agent IDs into buf without clearing it first.

fn len(&self) -> usize

Number of agents in the store.

fn contains(&self, id: AgentId) -> bool

Check whether an agent with the given ID exists.

fn is_empty(&self) -> bool

Returns true if the store contains no agents.

impl<A: Debug + Agent> Debug for HashMapStore<A>

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

Formats the value using the given formatter.

impl<A: Default + Agent> Default for HashMapStore<A>

fn default() -> HashMapStore<A>

Returns the “default value” for a type.