Struct PeerCache 

pub struct PeerCache { /* private fields */ }

In-memory cache PeerKey → PeerCapabilities.

One instance per participant; its lifetime matches the participant itself. Thread safety is provided by the caller via Arc<Mutex<PeerCache>> or Arc<RwLock<PeerCache>> — the cache itself is intentionally not thread-safe, because per tick usually only one writer/reader task touches it.

Implementations

impl PeerCache

pub fn new() -> Self

Build an empty cache.

pub fn len(&self) -> usize

Number of known peers.

pub fn is_empty(&self) -> bool

true if no peer is known.

pub fn insert(&mut self, key: PeerKey, caps: PeerCapabilities)

Full upsert. Overwrites an existing entry with the new capabilities. For partial updates use Self::update_partial.

pub fn get(&self, key: &PeerKey) -> Option<&PeerCapabilities>

Reads the capabilities of a peer.

pub fn update_partial(&mut self, key: PeerKey, update: &PeerCapabilities)

Merges new information into the existing entry. If the peer is new → it is inserted.

For the semantics see PeerCapabilities::merge_update.

pub fn forget(&mut self, key: &PeerKey) -> Option<PeerCapabilities>

Removes a peer from the cache. Returns the old caps if present — handy for logging at session end.

pub fn iter(&self) -> impl Iterator<Item = (&PeerKey, &PeerCapabilities)>

Iterator over all (PeerKey, PeerCapabilities) pairs.

Trait Implementations

impl Clone for PeerCache

fn clone(&self) -> PeerCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PeerCache

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

Formats the value using the given formatter.

impl Default for PeerCache

fn default() -> PeerCache

Returns the “default value” for a type.