Zighash is a zero-dependency Zig package for generating fast, non-cryptographic hash values using a variety of popular algorithms: FNV-1a, MurmurHash3, SpookyHash, xxHash, SuperFastHash, and CityHash. Perfect for hash-based data structures, checksums, deduplication, and performance-sensitive applications.
-
Multiple Hash Algorithms:
- FNV-1a:
fnv1aHash32,fnv1aHash64 - SuperFastHash:
superFastHash32 - MurmurHash3:
murmur3Hash32 - SpookyHash:
spookyHash32,spookyHash64 - xxHash:
xxHash32,xxHash64 - CityHash:
cityHash32,cityHash64
- FNV-1a:
-
Pure Zig Implementation: Zero dependencies, works at runtime and at comptime.
-
Comprehensive Testing: Built-in
std.testingsuite ensures correctness.
You can use the built‑in Zig fetcher to download and pin a tarball:
zig fetch --save git+https://github.com/galactixx/zighash#v0.2.0This adds an
zighashentry under.dependenciesin yourbuild.zig.zon.
Then in your build.zig:
const zighash_mod = b.dependency("zighash", .{
.target = target,
.optimize = optimize,
}).module("zighash");
// add to library
lib_mod.addImport("zighash", zighash_mod);
// add to executable
exe.root_module.addImport("zighash", zighash_mod);This lets you const zh = @import("zighash"); in your Zig code.
const std = @import("std");
const zh = @import("zighash");
pub fn main() void {
const key = "Hello, Zig!";
const hash32 = zh.fnv1aHash32(key);
const hash64 = zh.xxHash64(key);
std.debug.print("FNV-1a 32-bit: {x}\n", .{hash32});
std.debug.print("xxHash 64-bit: {x}\n", .{hash64});
}pub fn fnv1aHash32(key: []const u8) u32-
Parameters:
key: The input byte slice ([]const u8) to hash.
-
Returns: A 32-bit unsigned integer (
u32) representing the FNV-1a hash.
pub fn fnv1aHash64(key: []const u8) u64-
Parameters:
key: The input byte slice.
-
Returns: A 64-bit unsigned integer (
u64) representing the FNV-1a hash.
pub fn murmur3Hash32(key: []const u8, seed: u32) u32-
Parameters:
key: The input byte slice.seed: The 32-bit seed.
-
Returns: A 32-bit unsigned integer (
u32) computed by MurmurHash3.
pub fn spookyHash32(key: []const u8, seed: u32) u32
pub fn spookyHash64(key: []const u8, seed: u64) u64-
Parameters:
key: The input byte slice.seed: The 32-bit (u32) or 64-bit (u64) seed.
-
Returns: 32-bit (
u32) or 64-bit (u64) hash values.
pub fn xxHash32(key: []const u8, seed: u32) u32
pub fn xxHash64(key: []const u8, seed: u64) u64-
Parameters:
key: The input byte slice.seed: The 32-bit (u32) or 64-bit (u64) seed.
-
Returns: 32-bit or 64-bit non-cryptographic hash.
pub fn superFastHash32(key: []const u8) u32-
Parameters:
key: The input byte slice.
-
Returns: A 32-bit non-cryptographic hash.
pub fn cityHash32(key: []const u8) u32
pub fn cityHash64(key: []const u8) u64-
Parameters:
key: The input byte slice.
-
Returns: 32-bit or 64-bit hash optimized for varied input lengths.
This project is licensed under the MIT License. See the LICENSE file for details.
Have questions or want to contribute? Open an issue or pull request on GitHub.