crc Build Status

Rust implementation of CRC(32, 64)

Usage

Add crc to Cargo.toml toml [dependencies] crc = "0.3.0" or toml [dependencies.crc] git = "https://github.com/mrhooray/crc-rs"

Add this to crate root rust extern crate crc;

Compute CRC32

```rust use crc::{crc32, Hasher32};

// CRC-32-IEEE being the most commonly used one asserteq!(crc32::checksumieee(b"123456789"), 0xcbf43926); asserteq!(crc32::checksumcastagnoli(b"123456789"), 0xe3069283); asserteq!(crc32::checksumkoopman(b"123456789"), 0x2d3dd0ae);

// use provided or custom polynomial let mut digest = crc32::Digest::new(crc32::IEEE); digest.write(b"123456789"); assert_eq!(digest.sum32(), 0xcbf43926); ```

Compute CRC64

```rust use crc::{crc64, Hasher64};

asserteq!(crc64::checksumecma(b"123456789"), 0x995dc9bbdf1939fa); asserteq!(crc64::checksumiso(b"123456789"), 0xb90956c775a41001);

// use provided or custom polynomial let mut digest = crc64::Digest::new(crc64::ECMA); digest.write(b"123456789"); assert_eq!(digest.sum64(), 0x995dc9bbdf1939fa); ```

Benchmark

cargo bench with 2.3 GHz Intel Core i7 results ~400MB/s throughput. Comparison ``` running 14 tests test crc32::tests::testchecksumcastagnoli ... ignored test crc32::tests::testchecksumieee ... ignored test crc32::tests::testchecksumkoopman ... ignored test crc32::tests::testdigestcastagnoli ... ignored test crc32::tests::testdigestieee ... ignored test crc32::tests::testdigestkoopman ... ignored test crc64::tests::testchecksumecma ... ignored test crc64::tests::testchecksumiso ... ignored test crc64::tests::testdigestecma ... ignored test crc64::tests::testdigestiso ... ignored test crc32::tests::benchmaketable ... bench: 447 ns/iter (+/- 81) test crc32::tests::benchupdatemegabytes ... bench: 2479741 ns/iter (+/- 183031) test crc64::tests::benchmaketable ... bench: 1166 ns/iter (+/- 93) test crc64::tests::benchupdatemegabytes ... bench: 2478464 ns/iter (+/- 68731)

test result: ok. 0 passed; 0 failed; 10 ignored; 4 measured ```

TODO

License

MIT