csselection_sort 0.1.1

Selection sort implementation for indexable collections
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

# csselection_sort

Selection sort algorithm implementation over a vector.

Use this create to add a ``selection_sort`` and ``selection_sort_by`` methods
to Vec data type.

```rust
    use csselection_sort::SelectionSort; 
    
    let mut input: Vec<u32> = vec![2, 1];

    // this will sort items in ascending order 
    // using selection sort algorithm
    input.selection_sort();
    // input is now [1,2]
```

Use ``selection_sort_by`` to customize how items are compared. 
As second argument pass a function with the form: 
```rust 
fn(a: &T, b: &T) -> bool;
```
This function must return ``true`` to indicate that ``a`` is further to the left than ``b``.
For example, to sort a list of ``u32``, in descending order, ``by`` parameter can be: 
```rust
fn desc(a: u32, b: u32) -> bool {
    a < b
}
```
This example returns ``true`` when ``a=1`` and ``b==5`` in order to 
ensure that ``5`` is located at the left o ``1``.

For convenience ``asc`` and ``desc`` functions are provided. 

```rust
    use csselection_sort::{SelectionSort, des}; 
    
    let mut input: Vec<u32> = vec![1, 2];

    // this will sort items in descending order 
    // using selection sort algorithm
    input.selection_sort_by(desc);

    // input is now [2,1]
```

To call ``selection_sort`` is equivalent to call ``selection_sort_by(asc)``.