UCommon
|
A portable counting semaphore class. More...
#include <thread.h>
Public Member Functions | |
unsigned | getCount (void) |
Get active semaphore limit. | |
unsigned | getUsed (void) |
Get current semaphore usage. | |
void | operator++ (void) |
Convenience operator to wait on a counting semaphore. | |
void | operator-- (void) |
Convenience operator to release a counting semaphore. | |
void | release (void) |
Release the semaphore after waiting for it. | |
Semaphore (unsigned count=0) | |
Construct a semaphore with an initial count of threads to permit. | |
void | set (unsigned count) |
Alter semaphore limit at runtime. | |
void | wait (void) |
Wait until the semphore usage count is less than the thread limit. | |
bool | wait (timeout_t timeout) |
Wait until the semphore usage count is less than the thread limit. | |
Static Public Member Functions | |
static void | release (Semaphore &sync) |
Convenience class to release a semaphore. | |
static void | wait (Semaphore &sync) |
Convenience class to wait on a semaphore. | |
static bool | wait (Semaphore &sync, timeout_t timeout) |
Convenience class to wait on a semaphore. | |
Protected Member Functions | |
void | Shlock (void) |
Protocol interface to share lock the object. | |
void | Unlock (void) |
Protocol interface to release a lock. | |
Protected Attributes | |
unsigned | count |
unsigned | used |
unsigned | waits |
A portable counting semaphore class.
A semaphore will allow threads to pass through it until the count is reached, and blocks further threads. Unlike pthread semaphore, our semaphore class supports it's count limit to be altered during runtime and the use of timed waits. This class also implements the shared_lock protocol.
unsigned ucommon::Semaphore::getCount | ( | void | ) |
Get active semaphore limit.
unsigned ucommon::Semaphore::getUsed | ( | void | ) |
Get current semaphore usage.
static void ucommon::Semaphore::release | ( | Semaphore & | sync | ) | [inline, static] |
void ucommon::Semaphore::set | ( | unsigned | count | ) |
Alter semaphore limit at runtime.
count | of threads to allow. |
void ucommon::Semaphore::wait | ( | void | ) |
Wait until the semphore usage count is less than the thread limit.
Increase used count for our thread when unblocked.
Reimplemented from ucommon::Conditional.
bool ucommon::Semaphore::wait | ( | timeout_t | timeout | ) |
Wait until the semphore usage count is less than the thread limit.
Increase used count for our thread when unblocked, or return without changing if timed out.
timeout | to wait in millseconds. |
Reimplemented from ucommon::Conditional.
static void ucommon::Semaphore::wait | ( | Semaphore & | sync | ) | [inline, static] |