fletcher-simd

Crates.iofletcher-simd
lib.rsfletcher-simd
version0.4.0
sourcesrc
created_at2022-02-15 17:42:39.937194
updated_at2022-11-08 18:43:20.812544
descriptionA SIMD implementation of the Fletcher's checksum algorithm.
homepage
repositoryhttps://github.com/GodTamIt/fletcher-simd
max_upload_size
id532848
size19,681
Chris Tam (GodTamIt)

documentation

README

fletcher-simd

crates.io crates.io docs.rs

A SIMD implementation of the Fletcher's checksum algorithm.

Note: This implementation uses a modulus of 2^k where k is the checksum block size in bits, as this is fast with wrapping math. Other implementations may use 2^k - 1.

Features

  • Uses std::simd, which currently requires nightly.
  • Supports all architectures supported by std::simd.
  • Both run-time and compile-time detection available via the multiversion crate.
  • Scalar fallback.

Cargo features

There is one cargo feature, runtime_dispatch, enabled by default. When enabled, the crate will use CPU feature detection at runtime to dispatch to the appropriate SIMD implementation. Disabling this feature will result in static dispatch only.

Example

use byteorder::{ByteOrder, LittleEndian};
use fletcher_simd::Fletcher128;

fn main() {
    const DATA: &str = "abcdefgh";
    let mut fletcher = Fletcher128::new();

    // Read bytes in little endian. Endianness matters!
    fletcher.update_with_iter(
        DATA.as_bytes()
            .chunks(8)
            .map(|chunk| LittleEndian::read_u64(chunk)),
    );

    assert_eq!(fletcher.value(), 0x68676665646362616867666564636261);
}
Commit count: 12

cargo fmt