crc32fast

快速、SIMD加速的CRC32（IEEE）校验和计算

使用方法

简单用法

对于简单的用例，你可以直接调用hash便捷函数来计算给定字节切片的CRC32校验和：

let checksum = crc32fast::hash(b"foo bar baz");

高级用法

对于需要更多灵活性或性能的用例，例如处理大量数据时，你可以创建和操作一个Hasher：

use crc32fast::Hasher;

let mut hasher = Hasher::new();
hasher.update(b"foo bar baz");
let checksum = hasher.finalize();

性能

这个crate包含多个CRC32实现：

• 一个快速的基准实现，每次迭代处理最多16字节
• 一个针对现代x86使用sse和pclmulqdq指令的优化实现
• 一个针对aarch64使用crc32指令的优化实现

在运行时调用Hasher::new构造函数将执行特性检测，以选择当前CPU特性集最优的实现。

内存安全

由于优化实现使用了SIMD内联函数，这个crate包含一些unsafe代码。

为了确保内存安全，相关代码已使用afl.rs进行了数百万次迭代的模糊测试，包括debug和release构建设置。你可以在fuzz子目录中查看测试设置，那里也有关于如何自己运行测试的说明。

此外，每次提交都会在CI中使用地址sanitizer进行测试，以捕获任何越界内存访问。

尽管模糊测试和sanitization都未发现任何安全漏洞，但如果你遇到任何崩溃或其他意外行为，请不要犹豫，立即提交issue。

可用的特性标志

std（默认：启用）

该库支持在不使用Rust std库的情况下构建，这对于嵌入式等没有操作系统的低级用例很有用。要在no_std环境下构建crate，请禁用默认的std特性。

注意：由于运行时CPU特性检测需要操作系统支持，当禁用std特性时，专门的SIMD实现将不可用。

nightly（默认：禁用）

这个特性标志启用了只在nightly通道可用的不稳定特性。请记住，启用此特性标志时，在更新编译器版本时可能会遇到破坏性变更。

目前，启用此特性标志将使优化的aarch64实现可用。

许可证

本项目采用以下两种许可证之一：

• Apache License, Version 2.0，（LICENSE-APACHE或 http://www.apache.org/licenses/LICENSE-2.0）
• MIT license（LICENSE-MIT或 http://opensource.org/licenses/MIT）

由你选择。

贡献

除非你明确声明，否则你有意提交以包含在本项目中的任何贡献，按照Apache-2.0许可证的定义，均应按上述方式双重许可，无任何附加条款或条件。