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 is avaliable for. 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 135 of file NonRecursiveMutexImpl.cpp.

References BLOCXX_NAMESPACE::NonRecursiveMutex_t::mutex.

Referenced by BLOCXX_NAMESPACE::NonRecursiveMutex::acquire(), and BLOCXX_NAMESPACE::Mutex::acquire().

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

Definition at line 163 of file NonRecursiveMutexImpl.cpp.

Referenced by BLOCXX_NAMESPACE::NonRecursiveMutex::conditionPostWait().

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

Definition at line 156 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.

Parameters:

	handle	The mutex handle that should be initialized by this method
	isRecursive	Specified whether to create a recursive mutex

Returns:

0 on success. Otherwise -1.

Definition at line 59 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 112 of file NonRecursiveMutexImpl.cpp.

References BLOCXX_NAMESPACE::NonRecursiveMutex_t::mutex.

Referenced by BLOCXX_NAMESPACE::Mutex::~Mutex(), and 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.

Referenced by BLOCXX_NAMESPACE::NonRecursiveMutex::release(), and BLOCXX_NAMESPACE::NonRecursiveMutex::~NonRecursiveMutex().