Threads[Mutex]
Lock
lock a mutex
Calling Sequence
Parameters
Description
Examples
Lock( mutexid )
mutexid
-
(integer) the mutex to lock
The Lock command acquires the lock on the mutex with identifier mutexId for the current thread. If no thread holds the lock on mutexId, then Lock will acquire the lock and return immediately.
If a thread already holds the lock, then Lock will wait until the mutex is unlocked. Lock will then attempt to acquire the lock for the current thread.
To release the lock on a mutex, use the Unlock command.
When multiple threads are attempting to acquire the lock on a single mutex, there is no guarantee as to which thread will get the lock. This means that it is possible for a thread to unlock a mutex and then lock it again while other threads are waiting to acquire the lock.
For more information on using mutexes, see the Mutex help page.
p := proc( m ) global count; print( count ); count := count+1; end proc;
p≔procmglobalcount;printcount;count ≔ count+1end proc
count≔1
Create ten threads running the p function.
ThreadsWaitseqThreadsCreatepm,i=1..10
1
2
3
4
5
6
8
10
Without mutexes the same value may be printed multiple times. (You may have to execute this command multiple times to see this occur.)
p := proc( m ) global count; Threads[Mutex][Lock]( m ); print( count ); count := count+1; Threads[Mutex][Unlock]( m ); end proc;
p≔procmglobalcount;Threads[Mutex][Lock]m;printcount;count ≔ count+1;Threads[Mutex][Unlock]mend proc
m≔ThreadsMutexCreate
m≔1
Create ten threads running the new p function.
ThreadsWaitseqThreadsCreatepm,i=1..10:
7
9
Using a mutex allows you to control access to the shared variable. Thus each number will be printed only once.
ThreadsMutexDestroym
See Also
Threads
Threads[Create]
Threads[Mutex][Create]
Threads[Mutex][Destroy]
Threads[Mutex][Unlock]
Download Help Document
