Semaphore

Inherits: Reference < Object

A synchronization semaphore.

Description

A synchronization semaphore which can be used to synchronize multiple Threads. Initialized to zero on creation. Be careful to avoid deadlocks. For a binary version, see Mutex.

Tutorials

• Using multiple threads

Methods

Method Descriptions

• Error post ( )

Lowers the Semaphore, allowing one more thread in.

Note: This method internals’ can’t possibly fail, but an error code is returned for backwards compatibility, which will always be @GlobalScope.OK.

• Error try_wait ( )

Like wait, but won’t block, so if the value is zero, fails immediately and returns @GlobalScope.ERR_BUSY. If non-zero, it returns @GlobalScope.OK to report success.

• Error wait ( )

Waits for the Semaphore, if its value is zero, blocks until non-zero.

Note: This method internals’ can’t possibly fail, but an error code is returned for backwards compatibility, which will always be @GlobalScope.OK.