StorageHelperRK::CustomRecursiveMutex Class Reference

This is a wrapper around a recursive mutex, similar to Device OS RecursiveMutex. More...

#include <StorageHelperRK.h>

Inheritance diagram for StorageHelperRK::CustomRecursiveMutex:

Public Member Functions
	CustomRecursiveMutex (os_mutex_recursive_t handle)
	Construct a CustomRecursiveMutex wrapper object from an existing recursive mutex. More...
	CustomRecursiveMutex ()
	Default constructor with no mutex - one will be created on first lock.
	~CustomRecursiveMutex ()
	Destroys the underlying mutex object.
void	dispose ()
	Destroys the mutex object.
void	lock () const
	Locks the mutex. Creates a new recursive mutex object if it does not exist yet. More...
bool	trylock () const
	Attempts to lock the mutex. Creates a new recursive mutex object if it does not exist yet. More...
bool	try_lock () const
	Attempts to lock the mutex. Creates a new recursive mutex object if it does not exist yet. More...
void	unlock () const
	Unlocks the mutex. More...

Detailed Description

This is a wrapper around a recursive mutex, similar to Device OS RecursiveMutex.

There are two differences:

• The mutex is created on first lock, instead of from the constructor. This is done because it's not save to call os_mutex_recursive_create from a global constructor, and by delaying construction it makes it possible to safely construct the class as a global object.
• The lock/trylock/unlock methods are declared const acd nd the mutex handle mutable. This allows the mutex to be locked from a const method.

Constructor & Destructor Documentation

CustomRecursiveMutex()

StorageHelperRK::CustomRecursiveMutex::CustomRecursiveMutex ( os_mutex_recursive_t  handle )

inline

Construct a CustomRecursiveMutex wrapper object from an existing recursive mutex.

Parameters

handle

The mutex handle

Ownership of the mutex handle is transferred to this object and it will be destroyed when this object is deleted.

Member Function Documentation

lock()

void StorageHelperRK::CustomRecursiveMutex::lock ( ) const

inline

Locks the mutex. Creates a new recursive mutex object if it does not exist yet.

Blocks if another thread has obtained the mutex, continues when the other thread releases it.

Never call lock from a SINGLE_THREADED_BLOCK since deadlock can occur.

try_lock()

bool StorageHelperRK::CustomRecursiveMutex::try_lock ( ) const

inline

Attempts to lock the mutex. Creates a new recursive mutex object if it does not exist yet.

Returns true if the mutex was locked or false if another thread has already locked it.

trylock()

bool StorageHelperRK::CustomRecursiveMutex::trylock ( ) const

inline

Attempts to lock the mutex. Creates a new recursive mutex object if it does not exist yet.

Returns true if the mutex was locked or false if another thread has already locked it.

unlock()

void StorageHelperRK::CustomRecursiveMutex::unlock ( ) const

inline

Unlocks the mutex.

If another thread is blocked on locking the mutex, that thread will resume.

---

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

• src/StorageHelperRK.h