README.md

zigrc

Reference-counted pointers for Zig inspired by Rust's Rc and Arc

How to use

To use zigrc, import the src/root.zig file into your project, or add it as a module by running command shown below in your project directory.

# you can fetch via archive
zig fetch "https://github.com/Aandreba/zigrc/archive/refs/tags/0.4.0.tar.gz" --save=zigrc

# or fetch via git
zig fetch "git+https://github.com/Aandreba/zigrc#<ref id>" --save=zigrc

Then import it in your build file (build.zig):

pub fn build(b: *std.Build) void {
// ...
    // Import the dependency
    const zigrc_dep = b.dependency("zigrc", .{});

    // Extract the module
    const zigrc_mod = &zigrc_dep.artifact("zig-rc").root_module;

    // Add the dependency as an import to your library/executable
    exe.root_module.addImport("zigrc", zigrc_mod);
    lib.root_module.addImport("zigrc", zigrc_mod);
    unit_tests.root_module.addImport("zigrc", zigrc_mod);
// ...
}

Example

const std = @import("std");
const rc = @import("zigrc");

const Thread = std.Thread;
const Mutex = Thread.Mutex;

const ArrayList = std.ArrayList;
const Arc = rc.Arc(Data);

const THREADS = 8;

const Data = struct {
    mutex: Mutex = Mutex{},
    data: ArrayList(u64) = ArrayList(u64).init(std.testing.allocator),

    pub fn deinit(self: Data) void {
        self.data.deinit();
    }
};

test "example" {
    std.debug.print("\n", .{});
    std.debug.print("Data size: {}\n", .{@sizeOf(Data)});
    std.debug.print("Heap size: {}\n\n", .{Arc.innerSize()});

    std.debug.print("Data align: {}\n", .{@alignOf(Data)});
    std.debug.print("Heap align: {}\n\n", .{Arc.innerAlign()});

    var value = try Arc.init(std.testing.allocator, .{});
    errdefer if (value.releaseUnwrap()) |val| val.deinit();

    var handles: [THREADS]Thread = undefined;
    var i: usize = 0;
    while (i < THREADS) {
        const this_value = value.retain();
        errdefer if (this_value.releaseUnwrap()) |val| val.deinit();
        handles[i] = try Thread.spawn(.{}, thread_exec, .{this_value});
        i += 1;
    }

    for (handles) |handle| handle.join();
    const owned_value: Data = value.tryUnwrap().?;
    defer owned_value.deinit();

    std.debug.print("{d}\n", .{owned_value.data.items});
}

fn thread_exec(data: Arc) !void {
    defer if (data.releaseUnwrap()) |val| val.deinit();

    var rng = std.rand.DefaultPrng.init(@as(u64, @bitCast(@as(i64, @truncate(std.time.nanoTimestamp())))));

    data.value.mutex.lock();
    defer data.value.mutex.unlock();

    const value = rng.random().int(u64);
    try data.value.data.append(value);

    std.debug.print("{}: {}\n", .{ std.time.nanoTimestamp(), value });
}

Builds

Genrate docs zig build

Run tests zig build test

Run examples zig build example

Generate coverage report (requires kcov) zig build test -Dcoverage