MC-Basic:SEMAPHORETAKE
| Language: | English • 中文（简体） |
|---|
SEMTAKE acquires a semaphore that can be used for multi-task synchronization. If a semaphore is free, SEMTAKE returns 1 and the semaphore is marked as ‘taken’. If the semaphore is already taken, SEMTAKE returns 0 and the semaphore’s status does not change. SEMTAKE can be used to block simultaneous access to shared resources in the system or to a critical user software section.
If time-out is provided system will try to acquire a semaphore specified amount of time.
Semtake can return before specified timeout without acquiring a semaphore, therefore it is essential to check return value.
Short form
semTake
Syntax
<lval> = SemTake(<semaphore name> { , <timeout>})
Availability
Since Version 3.7.x
Type
Long
Range
return value: 0 = unsuccessful (semaphore not taken)
1 = succeessful (semaphore taken)
<timeout>: 0 to 5000
Units
milliseconds
Default
0
Scope
Task, Terminal
Examples
While semTake(SEM1,1000) = 0 ‘wait for the release of the semaphore
’wait for resource
End While
REM critical section code
……
……
semTake(SEM1) ‘take the semaphore
semTake(SEM1 , 100 )