zig/lib/std / event/locked.zig

Thread-safe async/await lock that protects one piece of data. Functions which are waiting for the lock are suspended, and are resumed when the lock is released, in order.

 
const std = @import("../std.zig");
const Lock = std.event.Lock;

Locked()

 

/// Thread-safe async/await lock that protects one piece of data.
/// Functions which are waiting for the lock are suspended, and
/// are resumed when the lock is released, in order.
pub fn Locked(comptime T: type) type {
    return struct {
        lock: Lock,
        private_data: T,

HeldLock

 

        const Self = @This();

release()

 

        pub const HeldLock = struct {
            value: *T,
            held: Lock.Held,

init()

 

            pub fn release(self: HeldLock) void {
                self.held.release();
            }
        };

deinit()

 

        pub fn init(data: T) Self {
            return Self{
                .lock = .{},
                .private_data = data,
            };
        }

acquire()

 

        pub fn deinit(self: *Self) void {
            self.lock.deinit();
        }

        pub fn acquire(self: *Self) callconv(.Async) HeldLock {
            return HeldLock{
                // TODO guaranteed allocation elision
                .held = self.lock.acquire(),
                .value = &self.private_data,
            };
        }
    };
}