core-dev 0.0.1

core-dev library is an utility library for rust. It contains a lot of useful functions and APIs to speed up development cycle.
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! Useful Docs for this module
//!
//! <https://rust-lang-nursery.github.io/rust-cookbook/algorithms/randomness.html#generate-random-numbers-within-a-range>


use rand::Rng;
use rand::random;
use rand::thread_rng;


use crate::stringlib::ASCII_LOWERCASE;
use crate::stringlib::ASCII_UPPERCASE;



pub fn random_float() -> f32 {
    random()
}


/// <https://rust-lang-nursery.github.io/rust-cookbook/algorithms/randomness.html#generate-random-values-of-a-custom-type>
pub fn random_i32() -> i32 {
    thread_rng().gen::<i32>()
}


pub fn random_digit() -> i32 {
    thread_rng().gen_range(0..10)
}


pub fn random_ascii_char() -> char {
    thread_rng().gen_range(0..128u8) as char
}


/// <https://www.asciitable.com/>
pub fn random_alpha_lower_char() -> char {
    let index = thread_rng().gen_range(0..26usize);
    ASCII_LOWERCASE[index]
}



/// <https://www.asciitable.com/>
pub fn random_alpha_upper_char() -> char {
    let index = thread_rng().gen_range(0..26usize);
    ASCII_UPPERCASE[index]
}


#[doc = include_str!("../../docs/random/random/fn_random_choice.md")]
/// extra doc
pub fn random_choice<T>(collection: &[T]) -> Option<&T> {
    // if collections is empty
    // then there is nothing to return from it
    if collection.is_empty() {
        return None;
    }
    // else generate index from 0 .. len - 1
    let index = thread_rng().gen_range(0..collection.len());
    // dbg!(&index);
    // return reference to the collection item
    collection.get(index)
}