Installation

[dependencies]array_tool ="~1.0.3"

externcrate array_tool;

use array_tool::vec::*;

Iterator Usage

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 value

Vector Usage

pubfnuniques<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 value

String Usage

use 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_value

Future plans

License

Contribution