zig: C-Library als Dependency nutzen

Die zig Community ist groß, aber die Anzahl nativer Zig Libraries wächst noch. Trotzdem kannst du problemlos jede C-Library in dein Zig Projekt importieren.

Schritt 1: C-Library holen und installieren

Wir verwenden cJSON als Beispiel.

1
zig fetch --save=cjson https://github.com/DaveGamble/cJSON/archive/refs/heads/master.zip

Schritt 2: build.zig anpassen

Jetzt müssen wir build.zig anpassen, um die Library in unser Executable einzubinden:

1
// ...
2
const cjsonDep = b.dependency("cjson", .{});
3
exe.addIncludePath(cjsonDep.path(""));
4
exe.linkLibC();
5
exe.addCSourceFiles(.{
6
    .root = .{
7
        .dependency = .{
8
            .dependency = cjsonDep,
9
            .sub_path = "",
10
        },
11
    },
12
    .files = &[_][]const u8{
13
        "cJSON.c",
14
    },
15
});
16
// ...

Schritt 3: C-Library in der Zig App nutzen

Jetzt kannst du die Public API von cJSON in deiner Zig App verwenden.

1
const c = @cImport({
2
    @cInclude("cJSON.h");
3
});
4

5
const value = c.cJSON_Parse(
6
    "{ \"name\": \"Patrick\" }",
7
);
8
defer std.c.free(value);
9
const name = c.cJSON_GetObjectItemCaseSensitive(
10
    value,
11
    "name",
12
);
13
defer std.c.free(name);
14
if (c.cJSON_IsString(name) == 1) {
15
    const str: [:0]u8 = std.mem.span(name.*.valuestring);
16
    std.debug.print(
17
        "name = {s}, len = {d}\n",
18
        .{
19
            str,
20
            str.len,
21
        },
22
    );
23
}

Output:

1
> zig build run
2
name = Patrick, len = 7

Mit diesem Ansatz kannst du Zig Anwendungen einfach mit dem großen C-Ecosystem erweitern, z.B. cJSON. Diese Flexibilität schließt die Lücke zwischen Zig und C nahtlos.

Source Code

Freelance-Entwickler