1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
#
#
# Nim's Runtime Library
# (c) Copyright 2015 Andreas Rumpf
#
# See the file "copying.txt", included in this
# distribution, for details about the copyright.
#
## This module contains Nim's support for locks and condition vars.
#[
for js, for now we treat locks as noop's to avoid pushing `when defined(js)`
in client code that uses locks.
]#
when not compileOption("threads") and not defined(nimdoc):
when false: # fix #12330
{.error: "Locks requires --threads:on option.".}
import std/private/syslocks
type
Lock* = SysLock ## Nim lock; whether this is re-entrant
## or not is unspecified!
Cond* = SysCond ## Nim condition variable
{.push stackTrace: off.}
proc `$`*(lock: Lock): string =
# workaround bug #14873
result = "()"
proc initLock*(lock: var Lock) {.inline.} =
## Initializes the given lock.
when not defined(js):
initSysLock(lock)
proc deinitLock*(lock: Lock) {.inline.} =
## Frees the resources associated with the lock.
deinitSys(lock)
proc tryAcquire*(lock: var Lock): bool {.inline.} =
## Tries to acquire the given lock. Returns `true` on success.
result = tryAcquireSys(lock)
proc acquire*(lock: var Lock) {.inline.} =
## Acquires the given lock.
when not defined(js):
acquireSys(lock)
proc release*(lock: var Lock) {.inline.} =
## Releases the given lock.
when not defined(js):
releaseSys(lock)
proc initCond*(cond: var Cond) {.inline.} =
## Initializes the given condition variable.
initSysCond(cond)
proc deinitCond*(cond: Cond) {.inline.} =
## Frees the resources associated with the condition variable.
deinitSysCond(cond)
proc wait*(cond: var Cond, lock: var Lock) {.inline.} =
## Waits on the condition variable `cond`.
waitSysCond(cond, lock)
proc signal*(cond: var Cond) {.inline.} =
## Sends a signal to the condition variable `cond`.
signalSysCond(cond)
proc broadcast*(cond: var Cond) {.inline.} =
## Unblocks all threads currently blocked on the
## specified condition variable `cond`.
broadcastSysCond(cond)
template withLock*(a: Lock, body: untyped) =
## Acquires the given lock, executes the statements in body and
## releases the lock after the statements finish executing.
acquire(a)
{.locks: [a].}:
try:
body
finally:
release(a)
{.pop.}
|
