rdeck 0.2.0

a simple library for choosing distinct random elements
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

use crate::prelude::*;

/// a [`Deck`] that randomly draws elements from a slice.
///
/// note that this works by randomly picking an *index* of the slice,
/// so it is possible to draw two card with equal value if (and only if)
/// the slice contains two elements of equal value.
///
/// [`Deck`]: trait.Deck.html 
pub struct SliceDeck<'a, R: Rng, T> {
	base: IntDeck<R>,
	slice: &'a [T],
}

impl<'a, R: Rng, T> Deck for SliceDeck<'a, R, T> {
	type Card = &'a T;
	fn left(&self) -> usize { self.base.left() }
	fn draw(&mut self) -> &'a T { &self.slice[self.base.draw()] }
	fn refill(&mut self) { self.base.refill() }
}


impl<'a, R: Rng, T> ToDeck<R> for &'a [T] {
	type Out = SliceDeck<'a, R, T>;
	fn to_deck(self, r: R) -> Self::Out {
		Self::Out {
			base: IntDeck::new(self.len(), r),
			slice: self,
		}
	}
}