Enum weighted_random_list::Entry

pub enum Entry<'container, T> {
    Vacant {
        arena: &'container mut WeightedRandomList<T>,
        needle: T,
    },
    Occupied {
        arena: &'container mut WeightedRandomList<T>,
        index: usize,
    },
}

Update or insert one entry inside the the list.

Variants

Vacant

Fields of Vacant

arena: &'container mut WeightedRandomList<T>needle: T

Occupied

Fields of Occupied

arena: &'container mut WeightedRandomList<T>index: usize

Methods

impl<'container, T> Entry<'container, T>

pub fn set_weight(&mut self, new_weight: usize)

Panics if Entry is Vacant

let mut l = WeightedRandomList::new();

l.push(12, 42);
let mut element = l.entry_first(&42).or_insert_with_weight(10);

element.set_weight(100);

pub fn or_insert_with_weight(self, weight: usize) -> Self

Inserts if Entry is Vacant. Does nothing if found inside the list.

let mut l = WeightedRandomList::new();

// add 42 with weight 10
l.entry_first(&42).or_insert_with_weight(10);

pub fn delete(self) -> Result<(), ()>

Remove Entry if it exists.

Errors if it does not exist.

let mut l = WeightedRandomList::new();
l.push(12, 11);
l.push(74, 22);
l.push(25, 33);

{
    let second = l.entry_first(&22);
    assert!(second.delete().is_ok(), "element was found and deleted");
}

{
    let second = l.entry_first(&22);
    assert!(second.delete().is_err(), "element alread gone");
}