structstd.Thread.WaitGroup[src]

Fields

state: std.atomic.Value(usize) = std.atomic.Value(usize).init(0)
event: std.Thread.ResetEvent = .{}

Functions

Functionstart[src]

pub fn start(self: *WaitGroup) void

Parameters

self: *WaitGroup

Source Code

Source code
pub fn start(self: *WaitGroup) void {
    const state = self.state.fetchAdd(one_pending, .monotonic);
    assert((state / one_pending) < (std.math.maxInt(usize) / one_pending));
}

FunctionstartMany[src]

pub fn startMany(self: *WaitGroup, n: usize) void

Parameters

self: *WaitGroup
n: usize

Source Code

Source code
pub fn startMany(self: *WaitGroup, n: usize) void {
    const state = self.state.fetchAdd(one_pending * n, .monotonic);
    assert((state / one_pending) < (std.math.maxInt(usize) / one_pending));
}

Functionfinish[src]

pub fn finish(self: *WaitGroup) void

Parameters

self: *WaitGroup

Source Code

Source code
pub fn finish(self: *WaitGroup) void {
    const state = self.state.fetchSub(one_pending, .acq_rel);
    assert((state / one_pending) > 0);

    if (state == (one_pending | is_waiting)) {
        self.event.set();
    }
}

Functionwait[src]

pub fn wait(self: *WaitGroup) void

Parameters

self: *WaitGroup

Source Code

Source code
pub fn wait(self: *WaitGroup) void {
    const state = self.state.fetchAdd(is_waiting, .acquire);
    assert(state & is_waiting == 0);

    if ((state / one_pending) > 0) {
        self.event.wait();
    }
}

Functionreset[src]

pub fn reset(self: *WaitGroup) void

Parameters

self: *WaitGroup

Source Code

Source code
pub fn reset(self: *WaitGroup) void {
    self.state.store(0, .monotonic);
    self.event.reset();
}

FunctionisDone[src]

pub fn isDone(wg: *WaitGroup) bool

Parameters

Source Code

Source code
pub fn isDone(wg: *WaitGroup) bool {
    const state = wg.state.load(.acquire);
    assert(state & is_waiting == 0);

    return (state / one_pending) == 0;
}

FunctionspawnManager[src]

pub fn spawnManager( wg: *WaitGroup, comptime func: anytype, args: anytype, ) void

Parameters

Source Code

Source code
pub fn spawnManager(
    wg: *WaitGroup,
    comptime func: anytype,
    args: anytype,
) void {
    if (builtin.single_threaded) {
        @call(.auto, func, args);
        return;
    }
    const Manager = struct {
        fn run(wg_inner: *WaitGroup, args_inner: @TypeOf(args)) void {
            defer wg_inner.finish();
            @call(.auto, func, args_inner);
        }
    };
    wg.start();
    const t = std.Thread.spawn(.{}, Manager.run, .{ wg, args }) catch return Manager.run(wg, args);
    t.detach();
}

Source Code

Source code
const builtin = @import("builtin");
const std = @import("std");
const assert = std.debug.assert;
const WaitGroup = @This();

const is_waiting: usize = 1 << 0;
const one_pending: usize = 1 << 1;

state: std.atomic.Value(usize) = std.atomic.Value(usize).init(0),
event: std.Thread.ResetEvent = .{},

pub fn start(self: *WaitGroup) void {
    const state = self.state.fetchAdd(one_pending, .monotonic);
    assert((state / one_pending) < (std.math.maxInt(usize) / one_pending));
}

pub fn startMany(self: *WaitGroup, n: usize) void {
    const state = self.state.fetchAdd(one_pending * n, .monotonic);
    assert((state / one_pending) < (std.math.maxInt(usize) / one_pending));
}

pub fn finish(self: *WaitGroup) void {
    const state = self.state.fetchSub(one_pending, .acq_rel);
    assert((state / one_pending) > 0);

    if (state == (one_pending | is_waiting)) {
        self.event.set();
    }
}

pub fn wait(self: *WaitGroup) void {
    const state = self.state.fetchAdd(is_waiting, .acquire);
    assert(state & is_waiting == 0);

    if ((state / one_pending) > 0) {
        self.event.wait();
    }
}

pub fn reset(self: *WaitGroup) void {
    self.state.store(0, .monotonic);
    self.event.reset();
}

pub fn isDone(wg: *WaitGroup) bool {
    const state = wg.state.load(.acquire);
    assert(state & is_waiting == 0);

    return (state / one_pending) == 0;
}

// Spawns a new thread for the task. This is appropriate when the callee
// delegates all work.
pub fn spawnManager(
    wg: *WaitGroup,
    comptime func: anytype,
    args: anytype,
) void {
    if (builtin.single_threaded) {
        @call(.auto, func, args);
        return;
    }
    const Manager = struct {
        fn run(wg_inner: *WaitGroup, args_inner: @TypeOf(args)) void {
            defer wg_inner.finish();
            @call(.auto, func, args_inner);
        }
    };
    wg.start();
    const t = std.Thread.spawn(.{}, Manager.run, .{ wg, args }) catch return Manager.run(wg, args);
    t.detach();
}