ion::base::GenericTryLockGuard< MutexT > Class Template Reference

A TryLockGuard attempts to lock a mutex when created, and if successful, will unlock it when destroyed. More...

#include "lockguards.h"

Inheritance diagram for ion::base::GenericTryLockGuard< MutexT >:

Collaboration diagram for ion::base::GenericTryLockGuard< MutexT >:

Public Member Functions
	GenericTryLockGuard (MutexT *m)
	The passed pointer must be non-NULL. More...
bool	IsLocked () const
	Returns whether this guard has locked the mutex; returns false even if another guard has it locked. More...
void	Lock ()
	Locks the mutex if it is not already locked by this guard. More...
bool	TryLock ()
	Attempts to lock the mutex if the mutex is not already locked by this guard. More...
void	Unlock ()
	Releases a lock on the mutex if it was previously locked by this guard. More...

Protected Attributes
MutexT &	mutex_
	The mutex used for locking. More...
bool	is_locked_
	Whether the mutex is currently locked by this guard. More...

Detailed Description

template<class MutexT>
class ion::base::GenericTryLockGuard< MutexT >

A TryLockGuard attempts to lock a mutex when created, and if successful, will unlock it when destroyed.

Use IsLocked() to determine if the initial lock was successful. A TryLockGuard never blocks.

Definition at line 106 of file lockguards.h.

Constructor & Destructor Documentation

template<class MutexT >

ion::base::GenericTryLockGuard< MutexT >::GenericTryLockGuard ( MutexT *  m )

inlineexplicit

The passed pointer must be non-NULL.

Definition at line 109 of file lockguards.h.

Member Function Documentation

template<class MutexT>

bool ion::base::GenericLockGuardBase< MutexT >::IsLocked ( ) const

inlineinherited

Returns whether this guard has locked the mutex; returns false even if another guard has it locked.

Use MutexT::IsLocked() to determine if the mutex itself is locked.

Definition at line 40 of file lockguards.h.

template<class MutexT>

void ion::base::GenericLockGuardBase< MutexT >::Lock ( )

inlineinherited

Locks the mutex if it is not already locked by this guard.

This function blocks if the mutex is locked elsewhere (e.g., by another guard).

Definition at line 44 of file lockguards.h.

template<class MutexT>

bool ion::base::GenericLockGuardBase< MutexT >::TryLock ( )

inlineinherited

Attempts to lock the mutex if the mutex is not already locked by this guard.

This function never blocks. Returns true if the mutex was successfully locked or if this guard has already locked it, and false otherwise.

Definition at line 55 of file lockguards.h.

template<class MutexT>

void ion::base::GenericLockGuardBase< MutexT >::Unlock ( )

inlineinherited

Releases a lock on the mutex if it was previously locked by this guard.

Definition at line 63 of file lockguards.h.

Member Data Documentation

template<class MutexT>

bool ion::base::GenericLockGuardBase< MutexT >::is_locked_

protectedinherited

Whether the mutex is currently locked by this guard.

Definition at line 81 of file lockguards.h.

template<class MutexT>

MutexT& ion::base::GenericLockGuardBase< MutexT >::mutex_

protectedinherited

The mutex used for locking.

Definition at line 79 of file lockguards.h.

---

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

• base/lockguards.h