nummap 0.5.1

Defines a wrapper around a `HashMap` of number values which behaves as if **ALL** keys are mapped but `0` values are not stored.
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

//! Author --- daniel.bechaz@gmail.com  
//! Last Moddified --- 2020-01-06

use super::*;
#[cfg(not(feature = "hashbrown",),)]
use std::collections::hash_map;
#[cfg(feature = "hashbrown",)]
use hashbrown::hash_map;

/// The Iterator which visits all non zero values in a [NumMap].
pub struct Iter<'a, K, V,>(pub(crate) Map<hash_map::Iter<'a, K, V::NonZero>, fn((&'a K, &'a V::NonZero,)) -> (&'a K, V,)>,)
  where V: Number;

impl<'a, K, V,> Iterator for Iter<'a, K, V,>
  where V: Number, {
  type Item = (&'a K, V,);

  #[inline]
  fn size_hint(&self,) -> (usize, Option<usize>,) { self.0.size_hint() }
  #[inline]
  fn next(&mut self,) -> Option<Self::Item> { self.0.next() }
}

/// The Iterator which visits all non zero values in a [NumMap].
pub struct Drain<'a, K, V,>(pub(crate) Map<hash_map::Drain<'a, K, V::NonZero>, fn((K, V::NonZero,)) -> (K, V,)>,)
  where V: Number;

impl<'a, K, V,> Iterator for Drain<'a, K, V,>
  where V: Number, {
  type Item = (K, V,);

  #[inline]
  fn size_hint(&self,) -> (usize, Option<usize>,) { self.0.size_hint() }
  #[inline]
  fn next(&mut self,) -> Option<Self::Item> { self.0.next() }
}

/// The IntoIterator type which visits all non zero values from a [NumMap].
#[derive(Debug,)]
pub struct IntoIter<K, V,>(pub(crate) Map<hash_map::IntoIter<K, V::NonZero>, fn((K, V::NonZero,)) -> (K, V,)>,)
  where V: Number;

impl<K, V,> Iterator for IntoIter<K, V,>
  where V: Number, {
  type Item = (K, V,);

  #[inline]
  fn size_hint(&self,) -> (usize, Option<usize>,) { self.0.size_hint() }
  #[inline]
  fn next(&mut self,) -> Option<Self::Item> { self.0.next() }
}

/// The Iterator which visits all non zero values in a [NumMap].
pub struct Values<'a, K, V,>(pub(crate) Map<hash_map::Values<'a, K, V::NonZero>, fn(&'a V::NonZero,) -> V>,)
  where V: Number;

impl<'a, K, V,> Iterator for Values<'a, K, V,>
  where V: Number, {
  type Item = V;

  #[inline]
  fn size_hint(&self,) -> (usize, Option<usize>,) { self.0.size_hint() }
  #[inline]
  fn next(&mut self,) -> Option<Self::Item> { self.0.next() }
}