hash
hash 模块提供了哈希值计算和 UUID 生成功能,这是 xmake 的一个内置模块。
hash.md5
- 计算字符串或文件的 MD5 哈希值
lua
local hashval = hash.md5("hello")
local hashval = hash.md5("/path/to/file")
计算指定字符串或文件的 MD5 哈希值,返回十六进制格式的哈希字符串。支持传入字符串或文件路径。
通常用于计算文件内容校验和:
lua
-- 读取文件内容并计算 MD5
local content = io.readfile("file.txt")
local checksum = hash.md5(content)
print("MD5: " .. checksum)
hash.sha1
- 计算字符串或文件的 SHA1 哈希值
lua
local hashval = hash.sha1("hello")
local hashval = hash.sha1("/path/to/file")
计算指定字符串或文件的 SHA1 哈希值,返回十六进制格式的哈希字符串。
hash.sha256
- 计算字符串或文件的 SHA256 哈希值
lua
local hashval = hash.sha256("hello")
local hashval = hash.sha256("/path/to/file")
计算指定字符串或文件的 SHA256 哈希值,返回十六进制格式的哈希字符串。
SHA256 比 MD5 更安全,常用于包的完整性校验:
lua
-- 校验下载的包文件
local packagefile = "package.tar.gz"
local checksum = hash.sha256(packagefile)
if checksum ~= expected_hash then
raise("checksum mismatch!")
end
hash.uuid
- 根据名称生成 UUID
lua
local id = hash.uuid("name")
根据给定的名称字符串生成一个确定性的 UUID,相同的名称总是生成相同的 UUID。
内部调用 hash.uuid4(str)
,格式为:xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
适合为特定配置生成固定的唯一标识符:
lua
-- 为不同的编译配置生成确定性 ID
local config_id = hash.uuid("debug-x64-windows")
hash.xxhash32
- 计算字符串或文件的 32 位 xxHash 哈希值
lua
local hashval = hash.xxhash32("hello")
local hashval = hash.xxhash32("/path/to/file")
使用 xxHash32 算法计算哈希值,xxHash 是一个极快的非加密哈希算法,适合用于哈希表、校验和等场景。
hash.xxhash64
- 计算字符串或文件的 64 位 xxHash 哈希值
lua
local hashval = hash.xxhash64("hello")
local hashval = hash.xxhash64("/path/to/file")
使用 xxHash64 算法计算哈希值,速度快,适合快速校验:
lua
-- 为编译参数生成快速哈希键
local key = hash.xxhash64(table.concat(params, "|"))
hash.xxhash128
- 计算字符串或文件的 128 位 xxHash 哈希值
lua
local hashval = hash.xxhash128("hello")
local hashval = hash.xxhash128("/path/to/file")
使用 xxHash128 算法计算哈希值,提供更长的哈希值以减少冲突。
hash.strhash32
- 从字符串生成 32 位哈希值
lua
local hashval = hash.strhash32("hello")
从字符串生成 32 位哈希值,返回格式如:91e8ecf1
这个接口内部使用 xxhash32,专门用于字符串快速哈希。
hash.strhash64
- 从字符串生成 64 位哈希值
lua
local hashval = hash.strhash64("hello")
从字符串生成 64 位哈希值,返回格式如:91e8ecf191e8ecf1
hash.strhash128
- 从字符串生成 128 位哈希值
lua
local hashval = hash.strhash128("hello")
从字符串生成 128 位哈希值,返回格式如:91e8ecf1417f4edfa574e22d7d8d204a
适合用于生成编译缓存键:
lua
-- 为编译缓存生成键
local cache_key = hash.strhash128(compiler .. flags .. source)
hash.rand32
- 生成 32 位随机哈希值
lua
local randval = hash.rand32()
生成一个 32 位的随机哈希值。
注意
此接口容易触发哈希冲突,不建议用于需要高唯一性的场景。
hash.rand64
- 生成 64 位随机哈希值
lua
local randval = hash.rand64()
生成一个 64 位的随机哈希值。
hash.rand128
- 生成 128 位随机哈希值
lua
local randval = hash.rand128()
生成一个 128 位的随机哈希值。