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.
Add the following to your Cargo.toml file
[dependencies]
array_tool = "~1.0.3"And in your rust files where you plan to use it put this at the top
externcrate array_tool;And if you plan to use all of the Vector helper methods available you may do
use array_tool::vec::*;This crate has helpful methods for strings as well.
use array_tool::iter::ZipOpt;fnzip_option<U:Iterator>(self,other:U) -> ZipOption<Self,U>whereSelf:Sized,U:IntoIterator;// let a = vec![1];// let b = vec![];// a.zip_option(b).next() // input// Some((Some(1), None)) // return valuepubfnuniques<T:PartialEq + Clone>(a:Vec<T>,b:Vec<T>) -> Vec<Vec<T>>// 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 valueuse array_tool::vec::Uniq;fnuniq(&self,other:Vec<T>) -> Vec<T>;// vec![1,2,3,4,5,6].uniq( vec![1,2,5,7,9] ) // input// vec![3,4,6] // return valuefnuniq_via<F:Fn(&T,&T) -> bool>(&self,other:Self,f:F) -> Self;// vec![1,2,3,4,5,6].uniq_via( vec![1,2,5,7,9], |&l, r| l == r + 2 ) // input // vec![1,2,4,6] // return valuefnunique(&self) -> Vec<T>;// vec![1,2,1,3,2,3,4,5,6].unique() // input// vec![1,2,3,4,5,6] // return valuefnunique_via<F:Fn(&T,&T) -> bool>(&self,f:F) -> Self;// vec![1.0,2.0,1.4,3.3,2.1,3.5,4.6,5.2,6.2].// unique_via( |l: &f64, r: &f64| l.floor() == r.floor() ) // input// vec![1.0,2.0,3.3,4.6,5.2,6.2] // return valuefnis_unique(&self) -> bool;// vec![1,2,1,3,4,3,4,5,6].is_unique() // input// false // return value// vec![1,2,3,4,5,6].is_unique() // input// true // return valueuse array_tool::vec::Shift;fnunshift(&mutself,other:T);// no return value, modifies &mut self directly// let mut x = vec![1,2,3];// x.unshift(0);// assert_eq!(x, vec![0,1,2,3]);fnshift(&mutself) -> Option<T>;// let mut x = vec![0,1,2,3];// assert_eq!(x.shift(), Some(0));// assert_eq!(x, vec![1,2,3]);use array_tool::vec::Intersect;fnintersect(&self,other:Vec<T>) -> Vec<T>;// vec![1,1,3,5].intersect(vec![1,2,3]) // input// vec![1,3] // return valuefnintersect_if<F:Fn(&T,&T) -> bool>(&self,other:Vec<T>,validator:F) -> Vec<T>;// vec!['a','a','c','e'].intersect_if(vec!['A','B','C'], |l, r| l.eq_ignore_ascii_case(r)) // input// vec!['a','c'] // return valueuse array_tool::vec::Join;fnjoin(&self,joiner:&'staticstr) -> String;// vec![1,2,3].join(",") // input// "1,2,3" // return valueuse array_tool::vec::Times;fntimes(&self,qty:i32) -> Vec<T>;// vec![1,2,3].times(3) // input// vec![1,2,3,1,2,3,1,2,3] // return valueuse array_tool::vec::Union;fnunion(&self,other:Vec<T>) -> Vec<T>;// vec!["a","b","c"].union(vec!["c","d","a"]) // input// vec![ "a", "b", "c", "d" ] // return valueuse array_tool::string::ToGraphemeBytesIter;fngrapheme_bytes_iter(&'aself) -> GraphemeBytesIter<'a>;// let string = "a s—d féZ";// let mut graphemes = string.grapheme_bytes_iter()// graphemes.skip(3).next(); // input// [226, 128, 148] // return value for emdash `—`use array_tool::string::Squeeze;fnsqueeze(&self,targets:&'staticstr) -> String;// "yellow moon".squeeze("") // input// "yelow mon" // return value// " now is the".squeeze(" ") // input// " now is the" // return valueuse array_tool::string::Justify;fnjustify_line(&self,width:usize) -> String;// "asd as df asd".justify_line(16) // input// "asd as df asd" // return value// "asd as df asd".justify_line(18) // input// "asd as df asd" // return valueuse array_tool::string::SubstMarks;fnsubst_marks(&self,marks:Vec<usize>,chr:&'staticstr) -> String;// "asdf asdf asdf".subst_marks(vec![0,5,8], "Z") // input// "Zsdf ZsdZ asdf" // return valueuse array_tool::string::WordWrap;fnword_wrap(&self,width:usize) -> String;// "01234 67 9 BC EFG IJ".word_wrap(6) // input// "01234\n67 9\nBC\nEFG IJ" // return valueuse array_tool::string::AfterWhitespace;fnseek_end_of_whitespace(&self,offset:usize) -> Option<usize>;// "asdf asdf asdf".seek_end_of_whitespace(6) // input// Some(9) // return value// "asdf".seek_end_of_whitespace(3) // input// Some(0) // return value// "asdf ".seek_end_of_whitespace(6) // input// None // return_valueExpect 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.
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (MIT-LICENSE or http://opensource.org/licenses/MIT)
at your option.
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.