wyhash 0.6.0

Rust implementation of the WyHash fast portable non-cryptographic hashing algorithm and random number generator.
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

use crate::v1::functions::{mix_with_p0, read64, wyhash_core, wyhash_finish, wyrng};
use core::hash::{BuildHasher, Hasher};
use rand_core::{impls, RngCore, SeedableRng};

/// WyHash hasher builder
#[derive(Clone, Debug, PartialEq, Eq, Ord, PartialOrd, Copy, Hash)]
pub struct WyHasherBuilder {
    seed: u64,
}

impl WyHasherBuilder {
    /// Create hasher builder with a seed
    pub fn new(seed: u64) -> Self {
        WyHasherBuilder { seed }
    }
}

impl Default for WyHasherBuilder {
    fn default() -> Self {
        WyHasherBuilder::new(0)
    }
}

impl BuildHasher for WyHasherBuilder {
    type Hasher = WyHash;

    fn build_hasher(&self) -> Self::Hasher {
        WyHash {
            h: self.seed,
            size: 0,
        }
    }
}

/// WyHash hasher
#[derive(Default, Clone, Copy, Debug, PartialEq, Eq, Ord, PartialOrd, Hash)]
pub struct WyHash {
    h: u64,
    size: u64,
}

impl WyHash {
    /// Create hasher with a seed
    pub fn with_seed(seed: u64) -> Self {
        WyHash { h: seed, size: 0 }
    }
}

impl Hasher for WyHash {
    #[inline]
    fn write(&mut self, bytes: &[u8]) {
        if bytes.is_empty() {
            self.h = mix_with_p0(self.h);
        } else {
            for bytes in bytes.chunks(u64::MAX as usize) {
                self.h = wyhash_core(bytes, self.h);
                self.size += bytes.len() as u64
            }
        }
    }
    #[inline]
    fn finish(&self) -> u64 {
        wyhash_finish(self.size, self.h)
    }
}

/// WyRng random number generator
#[derive(Default, Clone, Copy, Debug, PartialEq, Eq, Ord, PartialOrd, Hash)]
pub struct WyRng(u64);

impl RngCore for WyRng {
    fn next_u32(&mut self) -> u32 {
        self.next_u64() as u32
    }
    fn next_u64(&mut self) -> u64 {
        wyrng(&mut self.0)
    }
    fn fill_bytes(&mut self, dest: &mut [u8]) {
        impls::fill_bytes_via_next(self, dest)
    }
}

impl SeedableRng for WyRng {
    type Seed = [u8; 8];

    fn from_seed(seed: Self::Seed) -> Self {
        WyRng(read64(&seed))
    }

    fn seed_from_u64(state: u64) -> Self {
        WyRng(state)
    }
}