RecursiveMutualExclusion Class Reference

Recursive mutual exclusion synchronization object. More...

#include <base/concurrency/RecursiveMutualExclusion.h>

Inherits Resource, and Lock.

Public Types
typedef ExclusiveSynchronize< RecursiveMutualExclusion >	Sync
Public Types inherited from Lock
typedef ExclusiveSynchronize< Lock >	Sync

Public Member Functions
	RecursiveMutualExclusion ()
void	exclusiveLock () const
bool	tryExclusiveLock () const
void	sharedLock () const
bool	trySharedLock () const
void	releaseLock () const
	~RecursiveMutualExclusion ()
Public Member Functions inherited from Resource
String	getDescription () const
void	setDescription (const String &description)
unsigned int	getResourceId () const
unsigned int	getCreatedById () const
AnyReference	getHandle () const noexcept
template<class TYPE >
TYPE &	getInternalHandle () const
	operator bool () const noexcept
Public Member Functions inherited from Lock
	Lock () noexcept
virtual	~Lock ()

Additional Inherited Members
Protected Attributes inherited from Resource
AnyReference	handle

Detailed Description

Recursive mutual exclusion synchronization object.

This class implements a recursive mutual exclusion object.

See also

Lock

Version

1.1

Constructor & Destructor Documentation

RecursiveMutualExclusion()

RecursiveMutualExclusion::RecursiveMutualExclusion

(

)

Initializes a mutual exclusion object in the unlocked state. Raises ResourceException if unable to initialize the object.

~RecursiveMutualExclusion()

RecursiveMutualExclusion::~RecursiveMutualExclusion

(

)

Destroys the mutual exclusion object. The mutual exclusion must be in the unlocked state prior to destruction. Raises MutualExclusionException on failure.

Member Function Documentation

exclusiveLock()

void RecursiveMutualExclusion::exclusiveLock ( ) const

virtual

Requests a lock on this mutual exclusion object. The calling thread is suspended if the mutex has been locked by another thread. Does nothing if the calling thread already has a lock on the object. Raises MutualExclusionException on undefined failure.

Implements Lock.

releaseLock()

void RecursiveMutualExclusion::releaseLock ( ) const

virtual

This method unlocks this mutual exclusion object. The calling thread must have a lock on this mutual exlusion object prior to invocation otherwise the behavior is undefined. Raises MutualExclusionException on failure.

Implements Lock.

sharedLock()

void RecursiveMutualExclusion::sharedLock ( ) const

inlinevirtual

Requests a lock on this mutual exclusion object. The calling thread is suspended if the mutex has been locked by another thread. Does nothing if the calling thread already has a lock on the object. Raises MutualExclusionException on undefined failure.

Implements Lock.

tryExclusiveLock()

bool RecursiveMutualExclusion::tryExclusiveLock ( ) const

virtual

Attempts to lock this mutual exclusion object. Raises MutualExclusionException on failure.

Returns

True if the mutual exclusion was locked successfully or already was locked by the calling thread.

Implements Lock.

trySharedLock()

bool RecursiveMutualExclusion::trySharedLock ( ) const

inlinevirtual

Attempts to lock this mutual exclusion object. Raises MutualExclusionException on failure.

Returns

True if the mutual exclusion was locked successfully or already was locked by the calling thread.

Implements Lock.