original::pCondition Class Reference

POSIX condition variable implementation. More...

#include <condition.h>

Inheritance diagram for original::pCondition:

Collaboration diagram for original::pCondition:

Public Member Functions
	pCondition ()
	Constructs and initializes the condition variable.
void	wait (mutexBase &mutex) override
	Waits for notification while holding the mutex.
bool	waitFor (mutexBase &mutex, time::duration d) override
	Waits for notification with timeout.
void	notify () override
	Notifies one waiting thread.
void	notifyAll () override
	Notifies all waiting threads.
	~pCondition () override
	Destroys the condition variable.
virtual void	wait (mutexBase &mutex)=0
	Waits for notification while holding the mutex.
template<typename Pred >
void	wait (mutexBase &mutex, Pred predicate) noexcept(noexcept(predicate()))
	Waits until predicate becomes true.
virtual bool	waitFor (mutexBase &mutex, time::duration d)=0
	Waits for notification with timeout.
template<typename Pred >
bool	waitFor (mutexBase &mutex, const time::duration &d, Pred predicate) noexcept(noexcept(predicate()))
	Waits with timeout until predicate becomes true.
Public Member Functions inherited from original::conditionBase
	conditionBase ()=default
	Default constructor.
template<typename Pred >
void	wait (mutexBase &mutex, Pred predicate) noexcept(noexcept(predicate()))
	Waits until predicate becomes true.
template<typename Pred >
bool	waitFor (mutexBase &mutex, const time::duration &d, Pred predicate) noexcept(noexcept(predicate()))
	Waits with timeout until predicate becomes true.
void	notifySome (u_integer n)
	Notifies a specified number of waiting threads.
virtual	~conditionBase ()=default
	Virtual destructor.
	conditionBase (const conditionBase &)=delete
	Deleted copy constructor.
conditionBase &	operator= (const conditionBase &)=delete
	Deleted copy assignment operator.

Detailed Description

POSIX condition variable implementation.

Wrapper around pthread_cond_t with RAII semantics. Provides thread synchronization using POSIX condition variables.

Constructor & Destructor Documentation

pCondition()

original::pCondition::pCondition ( )

inlineexplicit

Constructs and initializes the condition variable.

Exceptions

sysError

if initialization fails

~pCondition()

original::pCondition::~pCondition ( )

inlineoverride

Destroys the condition variable.

Note

Calls pthread_cond_destroy()

Member Function Documentation

notify()

void original::pCondition::notify ( )

inlineoverridevirtual

Notifies one waiting thread.

Exceptions

sysError

if notification fails

Implements original::conditionBase.

notifyAll()

void original::pCondition::notifyAll ( )

inlineoverridevirtual

Notifies all waiting threads.

Exceptions

sysError

if notification fails

Implements original::conditionBase.

wait() [1/3]

void original::pCondition::wait ( mutexBase &  mutex )

inlineoverridevirtual

Waits for notification while holding the mutex.

Parameters

mutex

Locked mutex to wait on

Exceptions

sysError	if wait operation fails
valueError	if mutex is not a pMutex

Implements original::conditionBase.

wait() [2/3]

virtual void original::conditionBase::wait ( mutexBase &  mutex )

virtual

Waits for notification while holding the mutex.

Parameters

mutex

Locked mutex to wait on

Exceptions

sysError

if wait operation fails

Note

The mutex must be locked by the calling thread

Implements original::conditionBase.

wait() [3/3]

template<typename Pred >

void original::conditionBase::wait ( mutexBase &  mutex, Pred  predicate  )

noexcept

Waits until predicate becomes true.

Template Parameters

Pred	Predicate type (must be callable and return bool)

Parameters

mutex	Locked mutex to wait on
predicate	Condition predicate to check

Exceptions

sysError

if wait operation fails

Note

Implements the "wait with predicate" pattern to avoid spurious wakeups

waitFor() [1/3]

template<typename Pred >

bool original::conditionBase::waitFor ( mutexBase &  mutex, const time::duration &  d, Pred  predicate  )

noexcept

Waits with timeout until predicate becomes true.

Template Parameters

Pred	Predicate type (must be callable and return bool)

Parameters

mutex	Locked mutex to wait on
d	Maximum duration to wait
predicate	Condition predicate to check

Returns

true if predicate became true, false if timeout occurred

Exceptions

sysError

if wait operation fails

waitFor() [2/3]

bool original::pCondition::waitFor ( mutexBase &  mutex, time::duration  d  )

inlineoverridevirtual

Waits for notification with timeout.

Parameters

mutex	Locked mutex to wait on
d	Maximum duration to wait

Returns

true if notified, false if timeout occurred

Exceptions

sysError	if wait operation fails
valueError	if mutex is not a pMutex

Implements original::conditionBase.

waitFor() [3/3]

virtual bool original::conditionBase::waitFor ( mutexBase &  mutex, time::duration  d  )

virtual

Waits for notification with timeout.

Parameters

mutex	Locked mutex to wait on
d	Maximum duration to wait

Returns

true if notified, false if timeout occurred

Exceptions

sysError

if wait operation fails

Note

The mutex must be locked by the calling thread

Implements original::conditionBase.

---

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

• src/vibrant/condition.h