v/vlib/sync/waitgroup.v

61 lines
1.7 KiB
V
Raw Normal View History

// Copyright (c) 2019 Alexander Medvednikov. All rights reserved.
2019-07-30 15:06:16 +02:00
// Use of this source code is governed by an MIT license
// that can be found in the LICENSE file.
module sync
[trusted]
fn C.atomic_fetch_add_u32(voidptr, u32) u32
// WaitGroup
// Do not copy an instance of WaitGroup, use a ref instead.
//
// usage: in main thread:
// `wg := sync.new_waitgroup()
// `wg.add(nr_jobs)` before starting jobs with `go ...`
// `wg.wait()` to wait for all jobs to have finished
//
// in each parallel job:
// `wg.done()` when finished
//
2019-12-21 23:41:42 +01:00
// [init_with=new_waitgroup] // TODO: implement support for init_with struct attribute, and disallow WaitGroup{} from outside the sync.new_waitgroup() function.
[heap]
struct WaitGroup {
2019-07-30 15:06:16 +02:00
mut:
task_count u32 // current task count - reading/writing should be atomic
sem Semaphore // This blocks wait() until tast_countreleased by add()
2019-07-30 15:06:16 +02:00
}
pub fn new_waitgroup() &WaitGroup {
mut wg := &WaitGroup{}
wg.init()
return wg
2019-10-25 16:24:40 +02:00
}
pub fn (mut wg WaitGroup) init() {
wg.sem.init(0)
}
// add increments (+ve delta) or decrements (-ve delta) task count by delta
// and unblocks any wait() calls if task count becomes zero.
// add panics if task count drops below zero.
2020-05-17 13:51:18 +02:00
pub fn (mut wg WaitGroup) add(delta int) {
old_nrjobs := int(C.atomic_fetch_add_u32(&wg.task_count, u32(delta)))
new_nrjobs := old_nrjobs + delta
if new_nrjobs < 0 {
panic('Negative number of jobs in waitgroup')
}
if new_nrjobs == 0 {
wg.sem.post()
}
2019-07-30 15:06:16 +02:00
}
// done is a convenience fn for add(-1)
2020-05-17 13:51:18 +02:00
pub fn (mut wg WaitGroup) done() {
wg.add(-1)
2019-07-30 15:06:16 +02:00
}
// wait blocks until all tasks are done (task count becomes zero)
pub fn (mut wg WaitGroup) wait() {
wg.sem.wait() // blocks until task_count becomes 0
2019-07-30 15:06:16 +02:00
}