lossless-transform-utils 0.1.3

General purpose utility methods for creating lossless transforms for various file formats.
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

//! This module contains the implementation of a 'histogram'.
//!
//! A histogram is simply a counter of how many times an individual item has appeared
//! in a given dataset.
//!
//! For example, given the bytes `[0, 1, 2, 0, 1]`, the histogram would be `[2, 2, 1]`,
//! as bytes `0` and `1` appear two times, but the byte `2` appears once.
//!
//! The histogram code in this module is built around calculating occurrences of bytes, the amount
//! of times a byte has been met is stored.

pub mod histogram32;
pub use histogram32::*;

/// The implementation of a generic histogram, storing the for each byte using type `T`.
/// `T` should be a type that can be incremented.
#[repr(C)]
#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
pub struct Histogram<T> {
    pub counter: [T; 256],
}

#[cfg(any(test, feature = "bench"))]
pub mod histogram32_private;
#[cfg(any(test, feature = "bench"))]
pub use histogram32_private::*;

/// Benchmark only re-exports.
#[cfg(feature = "bench")]
pub mod bench {
    use super::Histogram32;

    pub fn histogram32_generic_batched_unroll_4_u32(bytes: &[u8], histogram: &mut Histogram32) {
        super::histogram32_generic_batched_unroll_4_u32(bytes, histogram)
    }

    pub fn histogram32_reference(bytes: &[u8], histogram: &mut Histogram32) {
        super::histogram32_reference(bytes, histogram)
    }
}