BLOCXX_NAMESPACE::NonRecursiveMutexImpl Namespace Reference

The NonRecursiveMutexImpl namespace represents the functionality needed by the blocxx non recursive Mutex class (NonRecursiveMutex). More...

Functions
int	createMutex (NonRecursiveMutex_t &handle)
	Create a platform specific mutext handle.
int	destroyMutex (NonRecursiveMutex_t &handle)
	Destroy a mutex previously created with createMutex.
int	acquireMutex (NonRecursiveMutex_t &handle)
	Acquire the mutex specified by a given mutex handle.
int	releaseMutex (NonRecursiveMutex_t &handle)
	Release a mutex that was previously acquired with the acquireMutex method.
int	conditionPreWait (NonRecursiveMutex_t &handle, NonRecursiveMutexLockState &state)
int	conditionPostWait (NonRecursiveMutex_t &handle, NonRecursiveMutexLockState &state)

---

Detailed Description

The NonRecursiveMutexImpl namespace represents the functionality needed by the blocxx non recursive Mutex class (NonRecursiveMutex).

The implementation for these function must be provided on all platforms that blocxx runs on. It is essentially an abstraction layer over another mutex implementation.

---

Function Documentation

int BLOCXX_NAMESPACE::NonRecursiveMutexImpl::acquireMutex (  NonRecursiveMutex_t &  handle  )

Acquire the mutex specified by a given mutex handle. This method should block until the desired mutex can be acquired. The error return value is used to indicate critical errors. Parameters: handle  The mutex to acquire. Returns: 0 on success. -1 indicates a critical error. Definition at line 124 of file NonRecursiveMutexImpl.cpp. References BLOCXX_NAMESPACE::NonRecursiveMutex_t::mutex.

int BLOCXX_NAMESPACE::NonRecursiveMutexImpl::conditionPostWait (  NonRecursiveMutex_t &  handle, NonRecursiveMutexLockState &  state )

Definition at line 173 of file NonRecursiveMutexImpl.cpp. Referenced by BLOCXX_NAMESPACE::NonRecursiveMutex::conditionPostWait().

int BLOCXX_NAMESPACE::NonRecursiveMutexImpl::conditionPreWait (  NonRecursiveMutex_t &  handle, NonRecursiveMutexLockState &  state )

Definition at line 163 of file NonRecursiveMutexImpl.cpp. References BLOCXX_NAMESPACE::NonRecursiveMutex_t::mutex, and BLOCXX_NAMESPACE::NonRecursiveMutexLockState::pmutex. Referenced by BLOCXX_NAMESPACE::NonRecursiveMutex::conditionPreWait().

int BLOCXX_NAMESPACE::NonRecursiveMutexImpl::createMutex (  NonRecursiveMutex_t &  handle  )

Create a platform specific mutext handle. Parameters: handle  The mutex handle that should be initialized by this method Returns: 0 on success. Otherwise -1. Definition at line 55 of file NonRecursiveMutexImpl.cpp. References BLOCXX_NAMESPACE::NonRecursiveMutex_t::mutex. Referenced by BLOCXX_NAMESPACE::NonRecursiveMutex::NonRecursiveMutex().

int BLOCXX_NAMESPACE::NonRecursiveMutexImpl::destroyMutex (  NonRecursiveMutex_t &  handle  )

Destroy a mutex previously created with createMutex. Parameters: handle  The handle to the mutex that will be destroyed. Returns: The following error codes: 0: success -1: Could not be acquired for destruction because it is currently locked. -2: All other error conditions Definition at line 94 of file NonRecursiveMutexImpl.cpp. References BLOCXX_NAMESPACE::NonRecursiveMutex_t::mutex. Referenced by BLOCXX_NAMESPACE::NonRecursiveMutex::~NonRecursiveMutex().

int BLOCXX_NAMESPACE::NonRecursiveMutexImpl::releaseMutex (  NonRecursiveMutex_t &  handle  )

Release a mutex that was previously acquired with the acquireMutex method. Parameters: handle  The handle to the mutex that is being released. Returns: 0 on success. -1 indicates a critical error. Definition at line 148 of file NonRecursiveMutexImpl.cpp. References BLOCXX_NAMESPACE::NonRecursiveMutex_t::mutex.

---