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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

use std::cmp::{Ord, Ordering};

/// A simple linear search
/// 
/// Returns index of the found item, None otherwise
///
/// # Arguments
/// * `slice`: slice of ordered data
/// * `item`: item to be searched for
///
/// # Examples
/// ```
/// use rudac::algo::search::linear_search;
///
/// let mut vec = vec![1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
///
/// assert_eq!(vec[linear_search(&vec, &1).unwrap()], 1);
/// assert_eq!(vec[linear_search(&vec, &2).unwrap()], 2);
/// assert_eq!(vec[linear_search(&vec, &3).unwrap()], 3);
///
/// assert_eq!(linear_search(&vec, &11), None);
/// assert_eq!(linear_search(&vec, &12), None);
/// assert_eq!(linear_search(&vec, &13), None);
/// ```
pub fn linear_search<T: Ord>(slice: &[T], item: &T) -> Option<usize> {
    linear_search_with(slice, item, &|x1: &T, x2: &T| x1.cmp(&x2))
}

/// A simple linear search
///
/// # Arguments
/// * `slice`: slice of ordered data
/// * `item`: item to be searched for
/// * `compare`: custom comparison closure
///
/// # Examples
/// ```
/// use rudac::algo::search::linear_search_with;
///
/// // consider a vector of 2d points
/// let mut vec = vec![(3,1), (4,2), (5,3), (3,4), (10,5), (2,6), (6,7), (9,8), (8,9), (1,10)];
/// 
/// let compare = |x1: &(usize, usize),x2: &(usize, usize)| {x1.1.cmp(&x2.1)};
/// assert_eq!(vec[linear_search_with(&vec, &(3,1), &compare).unwrap()], (3,1));
/// assert_eq!(vec[linear_search_with(&vec, &(4,2), &compare).unwrap()], (4,2));
/// assert_eq!(vec[linear_search_with(&vec, &(5,3), &compare).unwrap()], (5,3));
///
/// assert_eq!(linear_search_with(&vec, &(1,11), &compare), None);
/// assert_eq!(linear_search_with(&vec, &(1,12), &compare), None);
/// assert_eq!(linear_search_with(&vec, &(1,13), &compare), None);
/// ```
pub fn linear_search_with<T, F>(slice: &[T], item: &T, compare: &F) -> Option<usize>
where
    F: Fn(&T, &T) -> Ordering,
{
    for i in 0..slice.len() {
        if compare(&slice[i], item) == Ordering::Equal {
            return Some(i);
        }
    }
    None
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn algo_search_linear_search() {
        let mut vec = Vec::with_capacity(100);

        for i in 50..100 {
            vec.push(i);
        }

        for i in 50..100 {
            assert_eq!(vec[linear_search(&vec, &i).unwrap()], i);
        }

        for i in 0..50 {
            assert_eq!(linear_search(&vec, &i), None);
        }
        for i in 100..150 {
            assert_eq!(linear_search(&vec, &i), None);
        }
    }
}