crc Build Status

Rust implementation of CRC(32, 64) with support of various standards

Usage

Add crc to Cargo.toml toml [dependencies] crc = "^0.3.1" 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 ~430MB/s throughput. Comparison ``` cargo bench Running target/release/crc-ef3fd4a2422fe338

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: 2511 ns/iter (+/- 1256) test crc32::tests::benchupdatemegabytes ... bench: 2307480 ns/iter (+/- 483053) test crc64::tests::benchmaketable ... bench: 2510 ns/iter (+/- 928) test crc64::tests::benchupdatemegabytes ... bench: 2298012 ns/iter (+/- 78780)

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

TODO

License

MIT