array_tool

Build Status Documentation crates.io version License

Array helpers for Rust. Some of the most common methods you would use on Arrays made available on Vectors. Polymorphic implementations for handling most of your use cases.

Installation

Add the following to your Cargo.toml file [dependencies] array_tool = "0.3.4"

And in your rust files where you plan to use it put this at the top rust extern crate array_tool;

And if you plan to use all of the Vector helper methods available you may do rust use array_tool::vec::*;

This crate has helpful methods for strings as well.

Usage

```rust pub fn uniques(a: Vec, b: Vec) -> Vec> // array_tool::uniques(vec![1,2,3,4,5], vec![2,5,6,7,8]), // input // vec![vec![1,3,4], vec![6,7,8]] // return value

use arraytool::vec::Uniq; fn uniq(&self, other: Vec) -> Vec // vec![1,2,3,4,5,6].uniq( vec![1,2,5,7,9] ), // input // vec![3,4,6] // return value fn unique(&self) -> Vec // vec![1,2,1,3,2,3,4,5,6].unique(), // input // vec![1,2,3,4,5,6] // return value fn isunique(&self) -> bool // vec![1,2,1,3,4,3,4,5,6].isunique(), // input // false // return value // vec![1,2,3,4,5,6].isunique(), // input // true // return value

use arraytool::vec::Shift; fn unshift(&mut self, other: T) // no return value, modifies &mut self directly // let mut x = vec![1,2,3]; // x.unshift(0); // asserteq!(x, vec![0,1,2,3]); fn shift(&mut self) -> T // let mut x = vec![0,1,2,3]; // asserteq!(x.shift(), 0); // asserteq!(x, vec![1,2,3]);

use arraytool::vec::Intersect; fn intersect(&self, other: Vec) -> Vec // vec![1,1,3,5].intersect(vec![1,2,3]) // input // vec![1,3] // return value fn intersectif bool>(&self, other: Vec, validator: F) -> Vec // vec!['a','a','c','e'].intersectif(vec!['A','B','C'], |l, r| l.eqignoreasciicase(r)) // input // vec!['a','c'] // return value

use array_tool::vec::Join; fn join(&self, joiner: &'static str) -> String // vec![1,2,3].join(",") // input // "1,2,3" // return value

use array_tool::vec::Times; fn times(&self, qty: i32) -> Vec // vec![1,2,3].times(3) // input // vec![1,2,3,1,2,3,1,2,3] // return value

use array_tool::vec::Union; fn union(&self, other: Vec) -> Vec // vec!["a","b","c"].union(vec!["c","d","a"]) // input // vec![ "a", "b", "c", "d" ] // return value

use arraytool::string::Justify; fn justifyline(&self, width: usize) -> String; // "asd as df asd".justifyline(16) // input // "asd as df asd" // return value // "asd as df asd".justifyline(18) // input // "asd as df asd" // return value

use arraytool::string::SubstMarks; fn substmarks(&self, marks: Vec, chr: &'static str) -> String; // "asdf asdf asdf".subst_marks(vec![0,5,8], "Z") // input // "Zsdf ZsdZ asdf" // return value

use arraytool::string::WordWrap; fn wordwrap(&self, width: usize) -> String; // "01234 67 9 BC EFG IJ".word_wrap(6) // input // "01234\n67 9\nBC\nEFG IJ" // return value

use arraytool::string::AfterWhitespace; fn seekendofwhitespace(&self, offset: usize) -> Option; // "asdf asdf asdf".seekendofwhitespace(6) // input // Some(9) // output // "asdf".seekendofwhitespace(3) // input // Some(0) // output // "asdf ".seekendof_whitespace(6) // input // None // ouput

```

Future plans

Expect methods to become more polymorphic over time (same method implemented for similar & compatible types). I plan to implement many of the methods available for Arrays in higher languages; such as Ruby. Expect regular updates.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.