wpi::Semaphore Class Reference

A semaphore for synchronization. More...

#include <wpi/Synchronization.h>

Public Member Functions
	Semaphore (int initialCount=0, int maximumCount=INT_MAX)
	Constructor.
	~Semaphore ()
	Semaphore (const Semaphore &)=delete
Semaphore &	operator= (const Semaphore &)=delete
	Semaphore (Semaphore &&rhs)
Semaphore &	operator= (Semaphore &&rhs)
	operator WPI_Handle () const
	Gets the semaphore handle (e.g.
WPI_SemaphoreHandle	GetHandle () const
	Gets the semaphore handle (e.g.
bool	Release (int releaseCount=1, int *prevCount=nullptr)
	Releases N counts of the semaphore.

Detailed Description

A semaphore for synchronization.

Semaphores keep an internal counter. Releasing the semaphore increases the count. A semaphore with a non-zero count is considered signaled. When a waiter wakes up it atomically decrements the count by 1. This is generally useful in a single-supplier, multiple-consumer scenario.

Constructor & Destructor Documentation

Semaphore() [1/3]

wpi::Semaphore::Semaphore ( int initialCount = 0, int maximumCount = INT_MAX )

inlineexplicit

Constructor.

Parameters

initialCount	initial value for the semaphore's internal counter
maximumCount	maximum value for the semaphore's internal counter

~Semaphore()

wpi::Semaphore::~Semaphore ( )

inline

Semaphore() [2/3]

wpi::Semaphore::Semaphore ( const Semaphore & )

delete

Semaphore() [3/3]

wpi::Semaphore::Semaphore ( Semaphore && rhs )

inline

Member Function Documentation

GetHandle()

WPI_SemaphoreHandle wpi::Semaphore::GetHandle ( ) const

inline

Gets the semaphore handle (e.g.

for WaitForObject).

Returns

handle

operator WPI_Handle()

wpi::Semaphore::operator WPI_Handle ( ) const

inlineexplicit

Gets the semaphore handle (e.g.

for WaitForObject).

Returns

handle

operator=() [1/2]

Semaphore & wpi::Semaphore::operator= ( const Semaphore & )

delete

operator=() [2/2]

Semaphore & wpi::Semaphore::operator= ( Semaphore && rhs )

inline

Release()

bool wpi::Semaphore::Release ( int releaseCount = 1, int * prevCount = nullptr )

inline

Releases N counts of the semaphore.

Parameters

releaseCount	amount to add to semaphore's internal counter; must be positive
prevCount	if non-null, previous count (output parameter)

Returns

True on successful release, false on failure (e.g. release count would exceed maximum value, or handle invalid)

---

The documentation for this class was generated from the following file:

• wpi/Synchronization.h