Struct PlayerRegistry 

pub struct PlayerRegistry<Player: PlayerInfo> { /* private fields */ }

A registry for managing players by both their UUID and NFC UID.

The registry ensures that updates to players’ NFC UIDs automatically keep internal lookup maps in sync.

Implementations

impl<Player: PlayerInfo> PlayerRegistry<Player>

pub fn new(players: Vec<Player>) -> Self

Creates a new PlayerRegistry from a list of players

pub fn get_by_id(&self, id: Uuid) -> Option<Arc<RwLock<Player>>>

Returns the shared player reference (Arc) by their UUID.

Use Self::read_by_id() if you only need read access.

pub fn get_by_nfc_uid(&self, nfc_uid: NfcUid) -> Option<Arc<RwLock<Player>>>

Returns the shared player reference (Arc) by their NFC UID.

/// Use Self::read_by_nfc_uid() if you only need read access.

pub fn read_by_id(&self, id: Uuid) -> Option<RwLockReadGuard<'_, Player>>

Returns a read-only lock on a player by their UUID.

Returns None if no player with the given ID exists.

pub fn read_by_nfc_uid( &self, nfc_uid: NfcUid, ) -> Option<RwLockReadGuard<'_, Player>>

Returns a read-only lock on a player by their NFC UID.

Returns None if no player with the given NFC UID exists.

pub fn contains_id(&self, id: Uuid) -> bool

Returns true if a player with the given UUID exists in the registry.

pub fn mutate_by_id<F>(&mut self, id: Uuid, mutator: F)

where F: FnOnce(&mut Player),

Mutates a player by their UUID.

Automatically updates the internal NFC UID lookup map if the player’s NFC UID changes.

If no player with the given ID exists, this method does nothing.

pub fn add(&mut self, player: Player)

Adds a new player to the registry.

This method inserts the player into both internal lookup maps. If a player with the same ID or NFC UID already exists, it will be overwritten.

pub fn remove(&mut self, id: Uuid)

Removes a player from the registry by their UUID.

This also removes the player from the NFC UID lookup map. If no such player exists, this method does nothing.

Trait Implementations

impl<Player: Debug + PlayerInfo> Debug for PlayerRegistry<Player>

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

Formats the value using the given formatter.

impl<Player: PlayerInfo> From<Vec<Player>> for PlayerRegistry<Player>

fn from(players: Vec<Player>) -> Self

Converts to this type from the input type.