如何在Zig中创建等价于C# Dictionary/Java Map/Go map的键值对结构？

Zig标准库提供了std.HashMap类型，完全对应你提到的C# Dictionary、Java Map或Go map，用于高效存储和操作键值对。

创建与基本使用 #

Zig的HashMap需要显式指定键值类型、哈希/相等判断上下文，以及分配器（Zig要求手动管理内存）。以下是最常见的字符串键+数值值的示例：

const std = @import("std");
const HashMap = std.HashMap;

pub fn main() !void {
    // 初始化键为字符串、值为u32的HashMap
    var map = HashMap([]const u8, u32, std.hash_map.StringContext, std.hash_map.default_max_load_percentage).init(std.heap.page_allocator);
    defer map.deinit(); // 务必在结束前释放内存

    // 添加键值对
    try map.put("apple", 5);
    try map.put("banana", 3);
    try map.put("cherry", 8);

    // 获取指定键的值
    if (map.get("apple")) |count| {
        std.debug.print("apple: {d}\n", .{count});
    } else {
        std.debug.print("apple not found\n", .{});
    }

    // 遍历所有键值对
    std.debug.print("\nAll entries:\n", .{});
    for (map.iterator()) |entry| {
        std.debug.print("{s}: {d}\n", .{entry.key_ptr.*, entry.value_ptr.*});
    }
}

自定义键类型的HashMap #

如果需要用自定义结构体作为键，可使用std.hash_map.AutoContext（要求键类型支持==比较和std.hash.hash哈希计算），或手动实现哈希与相等判断逻辑：

const std = @import("std");
const HashMap = std.HashMap;

// 自定义键类型
const UserId = struct {
    id: u64,
};

pub fn main() !void {
    // 用AutoContext自动处理自定义键的哈希和相等判断
    var map = HashMap(UserId, []const u8, std.hash_map.AutoContext(UserId), std.hash_map.default_max_load_percentage).init(std.heap.page_allocator);
    defer map.deinit();

    try map.put(.{.id = 1001}, "Alice");
    try map.put(.{.id = 1002}, "Bob");

    // 查询自定义键对应的值
    if (map.get(.{.id = 1001})) |name| {
        std.debug.print("User 1001: {s}\n", .{name});
    }
}

关键注意事项 #

• 必须调用deinit()释放HashMap内存，防止泄漏。
• put方法会覆盖已存在的键对应值，若要避免覆盖可使用putIfAbsent，它会返回原有值（若键已存在）。
• 字符串键推荐使用std.hash_map.StringContext，它内置了针对字符串的优化哈希和相等判断逻辑。

内容的提问来源于stack exchange，提问作者zacoons