collection_tools 0.49.0

General purpose tools to manipulate collections( containers like Vec/HashMap/HashSet ).
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use super :: *;

#[ test ]
#[ cfg(any(feature = "use_alloc", not(feature = "no_std"))) ]
fn reexport() 
{
  let vec1: the_module ::Vec< i32 > = std ::vec![ 1, 2 ];
  let got = *vec1.first().unwrap();
  assert_eq!(got, 1);
  let got = *vec1.last().unwrap();
  assert_eq!(got, 2);

  use std ::vec ::Vec as DynList;
  let vec2: DynList< i32 > = DynList ::from([ 1, 2 ]);
  let got = *vec2.first().unwrap();
  assert_eq!(got, 1);
  let got = *vec2.last().unwrap();
  assert_eq!(got, 2);

  assert_eq!(vec1, vec2);
}

#[ cfg( feature = "collection_constructors" ) ]
#[ test ]
fn constructor() 
{
  // test.case( "empty" );
  let got: the_module ::Vec< i32 > = std ::vec! {};
  let exp = the_module ::Vec :: < i32 > ::new();
  assert_eq!(got, exp);

  // test.case( "multiple entry" );
  let got = std ::vec! { 3, 13 };
  let exp = std ::vec![ 3, 13 ];
  assert_eq!(got, exp);

  let _got = std ::vec!("b");
  let _got = the_module ::dlist!("b");
  let _got = the_module ::exposed ::dlist!("b");
}

#[ cfg( feature = "collection_into_constructors" ) ]
#[ test ]
fn into_constructor() 
{
  // test.case( "empty" );
  let got: the_module ::Vec< i32 > = the_module ::into_vec! {};
  let exp = the_module ::Vec :: < i32 > ::new();
  assert_eq!(got, exp);

  // test.case( "multiple entry" );
  let got: the_module ::Vec< i32 > = the_module ::into_vec! { 3, 13 };
  let exp = std ::vec![ 3, 13 ];
  assert_eq!(got, exp);

  let _got: Vec< &str > = the_module ::into_vec!("b");
  let _got: Vec< &str > = the_module ::exposed ::into_vec!("b");
  let _got: Vec< &str > = the_module ::into_dlist!("b");
  let _got: Vec< &str > = the_module ::exposed ::into_dlist!("b");
}

#[ test ]
fn iters()
{
  struct MyContainer 
  {
  entries: Vec< i32 >,
 }

  impl IntoIterator for MyContainer 
  {
  type Item = i32;
  type IntoIter = the_module ::vector ::IntoIter< i32 >;

  fn into_iter(self) -> Self ::IntoIter 
  {
   self.entries.into_iter()
 }
 }

  impl< 'a > IntoIterator for &'a MyContainer 
{
  type Item = &'a i32;
  type IntoIter = the_module ::vector ::Iter< 'a, i32 >;

  fn into_iter(self) -> Self ::IntoIter 
  {
   self.entries.iter()
 }
 }

  impl< 'a > IntoIterator for &'a mut MyContainer 
{
  type Item = &'a mut i32;
  type IntoIter = the_module ::vector ::IterMut< 'a, i32 >;

  fn into_iter(self) -> Self ::IntoIter 
  {
   self.entries.iter_mut()
 }
 }

  let instance = MyContainer {
  entries: the_module ::Vec ::from([1, 2, 3]),
 };
  let got: Vec< _ > = instance.into_iter().collect();
  let exp = the_module ::Vec ::from([1, 2, 3]);
  assert_eq!(got, exp);

  let instance = MyContainer {
  entries: the_module ::Vec ::from([1, 2, 3]),
 };
  let got: Vec< _ > = (&instance).into_iter().copied().collect();
  let exp = the_module ::Vec ::from([1, 2, 3]);
  assert_eq!(got, exp);

  let mut instance = MyContainer {
  entries: the_module ::Vec ::from([1, 2, 3]),
 };
  (&mut instance).into_iter().for_each(|v| *v *= 2);
  let exp = the_module ::Vec ::from([2, 4, 6]);
  assert_eq!(instance.entries, exp);
}