underscore::vec

Trait underscore::vec::VecU [-] [+] [src]

pub trait VecU<T> {
    fn first<'a>(&'a self) -> Option<&'a T>;
    fn without(self, values: &Vec<T>) -> Vec<T>;
    fn intersection(self, intersec: &Vec<T>) -> Vec<T>;
    fn uniq(self) -> Vec<T>;
    fn index_of(&self, value: &T) -> Option<usize>;
    fn last_index_of(&self, value: &T) -> Option<usize>;
    fn object<V: Clone>(self, value: Vec<V>) -> BTreeMap<T, V>;
    fn reject<F: Fn(&T) -> bool>(self, f: F) -> Vec<T>;
}

UnderscoreVec expands collections::vec::Vec

Required Methods

fn first<'a>(&'a self) -> Option<&'a T>

Returns the first element of a vector as Option.

Example

use underscore::vec::VecU;

let sample = vec!(1isize, 2, 3);
assert_eq!(1isize, *sample.first().unwrap());

fn without(self, values: &Vec<T>) -> Vec<T>

Returns a copy of the vector with all instances of the values removed.

Example

use underscore::vec::VecU;

let sample = vec!(1isize, 2isize, 2isize);
assert_eq!(vec!(2isize, 2isize), sample.without(&vec!(1isize)));

fn intersection(self, intersec: &Vec<T>) -> Vec<T>

Computes the list of values that are the intersection of argument vector. Each value in the result is present in each of the arrays.

Example

use underscore::vec::VecU;

let sample = vec!(1isize, 2, 3);
assert_eq!(vec!(2isize, 3), sample.intersection(&vec!(2isize, 3, 4)));

fn uniq(self) -> Vec<T>

Produces a duplicate-free version of the vector.

Example

use underscore::vec::VecU;

let sample = vec!(0isize, 1, 1, 1, 2, 2, 2, 3);
assert_eq!(vec!(0isize, 1, 2, 3), sample.uniq());

fn index_of(&self, value: &T) -> Option<usize>

Returns the Option with index which value can be found in the vector. Pass true for is_sorted to use sorted vector.

Example

use underscore::vec::VecU;

let sample = vec!(3isize, 2, 1);
assert_eq!(2usize, sample.index_of(&1isize).unwrap());

fn last_index_of(&self, value: &T) -> Option<usize>

Returns the Option with index which value can be found in the vector.

Example

use underscore::vec::VecU;

let sample = vec!(1isize, 2, 3, 1);
assert_eq!(3usize, sample.last_index_of(&1isize).unwrap());

fn object<V: Clone>(self, value: Vec<V>) -> BTreeMap<T, V>

Converts vector into BTreeMap.

Example

use underscore::vec::VecU;

let obj = vec!(0usize, 1, 2, 3).object(vec!(0isize, 1, 2, 3));
//=> BTreeMap<0usize, 0isize><1u, 1isize>...

fn reject<F: Fn(&T) -> bool>(self, f: F) -> Vec<T>

reject the values in Vector without the elements that the truth test (predicate) passes. The opposite of vec!().iter().filter();

Example

use underscore::vec::VecU;

let sample = vec!(1isize, 2, 10);
assert_eq!(vec!(10isize), sample.reject(|&v| v < 10));

Implementors