Struct EquipmentSlots 

pub struct EquipmentSlots<I: Copy + Eq + Hash + Debug, S: Copy + Eq + Hash + Debug> { /* private fields */ }

A collection of equipment slots that tracks which item (if any) is equipped in each slot.

Type parameters

• I — Item identifier type.
• S — Slot identifier type (typically EquipSlot<Id> or a game-specific enum).

Implementations

impl<I: Copy + Eq + Hash + Debug, S: Copy + Eq + Hash + Debug> EquipmentSlots<I, S>

pub fn new(slots: &[S]) -> Self

where S: Clone,

Create an empty equipment set from the given slots.

All slots start with no item equipped.

pub fn from_pairs(pairs: Vec<(S, I)>) -> Self

Create an equipment set from a list of slot-item pairs.

If a slot appears multiple times the last associated item wins. Any slot not present in pairs will not exist in the resulting set.

impl<I: Copy + Eq + Hash + Debug, S: Copy + Eq + Hash + Debug> EquipmentSlots<I, S>

pub fn equipped_in(&self, slot: &S) -> Option<&I>

Returns a reference to the item equipped in slot, or None if the slot is empty or does not exist.

pub fn all_equipped(&self) -> Vec<(S, I)>

where S: Clone, I: Clone,

Returns all occupied slot-item pairs.

pub fn is_equipped(&self, item: &I) -> bool

Returns true if item is equipped in any slot.

pub fn slot_count(&self) -> usize

Returns the total number of slots (both occupied and empty).

pub fn iter(&self) -> impl Iterator<Item = &(S, Option<I>)>

Returns an iterator over all slot entries.

impl<I: Copy + Eq + Hash + Debug, S: Copy + Eq + Hash + Debug> EquipmentSlots<I, S>

pub fn equip(&mut self, slot: S, item: I) -> Result<(), EquipError>

Equip item into slot.

Errors

• EquipError::SlotFull — the slot already has an item.
• EquipError::InvalidSlot — slot does not exist in this set.

pub fn unequip(&mut self, slot: &S) -> Option<I>

Remove and return the item equipped in slot, or None if the slot is empty or does not exist.

pub fn swap(&mut self, a: &S, b: &S) -> Result<(), EquipError>

Swap the items in two slots (including empty ↔ occupied).

Errors

• EquipError::InvalidSlot — either a or b does not exist.

pub fn clear(&mut self) -> Vec<I>

Unequip all slots and return the previously-equipped items.

After this call every slot is empty.

Trait Implementations

impl<I: Clone + Copy + Eq + Hash + Debug, S: Clone + Copy + Eq + Hash + Debug> Clone for EquipmentSlots<I, S>

fn clone(&self) -> EquipmentSlots<I, S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<I: Debug + Copy + Eq + Hash + Debug, S: Debug + Copy + Eq + Hash + Debug> Debug for EquipmentSlots<I, S>

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

Formats the value using the given formatter.

impl<I: Eq + Copy + Eq + Hash + Debug, S: Eq + Copy + Eq + Hash + Debug> Eq for EquipmentSlots<I, S>

impl<I: PartialEq + Copy + Eq + Hash + Debug, S: PartialEq + Copy + Eq + Hash + Debug> PartialEq for EquipmentSlots<I, S>

fn eq(&self, other: &EquipmentSlots<I, S>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<I: PartialEq + Copy + Eq + Hash + Debug, S: PartialEq + Copy + Eq + Hash + Debug> StructuralPartialEq for EquipmentSlots<I, S>