random_item 0.1.0

Easily reference or clone a random item from a sequential collection.
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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# Random Item

Get a random item out of a sequential collection.

## Getting A Reference

```rs
use random_item::random_item;

let numbers = (0..99).collect::<Vec<u8>>();

let random_number = random_item(&numbers);
```

## Getting An Owned Value (Cloned)

```rs
use random_item::random_item;

let messages = Vec::from([
   String::from("Hello, "),
   String::from("fellow "),
   String::from("Rustaceans!"),
]);

let random_message = random_owned_item(&messages);
```

```rs
use random_item::random_item;

#[derive(PartialEq, Clone)]
struct Shape {
   sides: u32,
}

let fruits = [
   Shape { sides: 1 },
   Shape { sides: 1 },
   Shape { sides: 2 },
   Shape { sides: 3 },
   Shape { sides: 5 },
   Shape { sides: 8 },
   Shape { sides: 13 },
   Shape { sides: 21 },
];

let random_fruit = random_owned_item(&fruits);
```