介绍

adler4cj 是一个用于计算数据校验和的算法库，实现了 Adler-32 校验和算法。该算法由 Mark Adler 创建，相比 CRC32 具有更快的计算速度，被广泛应用于数据完整性校验、网络传输和压缩文件格式（如 zlib）中。

项目特性

• 支持多种数据类型的校验和计算

  • 二进制字符串
  • 字节数组
  • UTF-8 字符串

• 高性能实现

  • 优化的缓冲区处理
  • 高效的位运算操作

• 灵活的种子值支持

  • 支持自定义初始种子值
  • 兼容标准 Adler-32 算法默认值

项目架构

源码目录

.
├── README.md                # 项目说明文档
├── doc                      # 文档目录
│   ├── design.md           # 设计文档
│   └── feature_api.md      # API接口文档
└── src                     # 源码目录
    ├── adler32.cj         # Adler32 核心实现
    └── adler32_test.cj    # 单元测试

接口说明

提供三个主要的静态方法用于计算 Adler32 校验和：

• adler32_bstr(bstr: String, seed: Int64): 计算二进制字符串的校验和
• adler32_buf(buf: Array<UInt8>, seed: Int64): 计算字节数组的校验和
• adler32_str(str: String, seed: Int64): 计算 UTF-8 字符串的校验和

详细接口说明请参考 API

使用说明

编译构建

cpm update
cpm build

功能示例

计算字符串校验和

示例代码如下：

import adler32.*

func main() {
    let text = "Hello, World!"
    let checksum = Adler32.adler32_str(text, -1)
    println("Adler32 checksum: ${checksum}")
}

执行结果如下：

Adler32 checksum: 300286872

计算字节数组校验和

示例代码如下：

import adler32.*

func main() {
    let data = [0x48_u8, 0x65_u8, 0x6C_u8, 0x6C_u8, 0x6F_u8] // "Hello"
    let checksum = Adler32.adler32_buf(data, -1)
    println("Adler32 checksum: ${checksum}")
}

约束与限制

• 需要 CangJie 0.53.4 或更高版本
• 输入数据大小不应超过系统内存限制
• 校验和结果使用 64 位整数表示

开源协议

Apache License 2.0

参与贡献

欢迎参与项目贡献！您可以：

• 提交 Issue 报告问题或建议新功能
• 提交 Pull Request 改进代码
• 完善项目文档
• 分享使用经验

我们感谢任何形式的贡献。