citadel 0.2.0

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

//! Functions pertaining to the indexing of sets of data, as well as metadata
//! of such data.

use prelude;

/// Locate the indices of occurences of an element in a given list.
/// # Examples
/// ```
/// let spots_of_a = positions(&['a', 'a', 'b', 'a'], 'a')
///```
pub fn positions<T: Eq>(list: &[T], item: T) -> Vec<i32> {
    let mut collector: Vec<i32> = vec![];

    for counter in 0 .. list.len() {
        if list[counter] == item {
            collector.push(counter.clone() as i32);
        }
    }

    return collector;
}

/// Return everything before a match of the item.
/// # Examples
///
/// ```
/// use citadel::access::stat;
/// let one_two_three = stat::before(&[1, 2, 3, 4, 5], 4);
/// ```
pub fn before<T: Eq+Clone>(list: &[T], item: T) -> Vec<T> {
    prelude::filter_break(list, |c: &T| -> bool {*c != item})
}

/// Return everything after the match of an item.
/// # Examples
/// ```
/// use citadel::access::stat;
/// let one_two_three = stat::after(&[4, 5, 1, 2, 3], 5)
///```
pub fn after<T: Eq+Clone>(list: &[T], item: T) -> Vec<T> {
    prelude::drop_break(list, |c: &T| -> bool {*c != item})
}

/// Returns everything between two delimeters.
/// # Examples
/// ```
/// use citadel::access::stat;
/// let one_two_three = stat::between(&[1, 2, 3, 1], vec![2, 3]);
///```
pub fn between<T: Eq+Clone>(list: &[T], (d1, d2): (T, T)) -> Vec<T> {
    before(&after(list, d1), d2)
}