RWTWriteGuardBase< T > Class Template Reference

A base class for guard classes that support write access to a given section of code. More...

#include <rw/sync/RWTWriteGuardBase.h>

Public Member Functions
	~RWTWriteGuardBase ()
void	acquire ()
bool	isAcquired () const
void	release ()

Protected Member Functions
	RWTWriteGuardBase (Resource &resource)
Resource &	resource () const

Private Member Functions
	RWTWriteGuardBase (const RWTWriteGuardBase< Resource > &second)
RWTWriteGuardBase< Resource > &	operator= (const RWTWriteGuardBase< Resource > &second)

Detailed Description

template<class T>
class RWTWriteGuardBase< T >

RWTWriteGuardBase<Resource> is a base class for guard classes that need to support write access to a given section of code. Guard objects work in conjunction with block statements to establish an appropriate state upon creation, maintain that state for the duration of the block, and restore the original state upon destruction. For example, a guard may acquire a mutex for writing when created and release it when destructed.

The class used as the actual template parameter for Resource must provide acquireWrite() and release() methods, such as the synchronization classes in this module.

See Also

RWTWriteLockGuardBase<Resource> , RWTWriteLockGuard<Resource> , RWTWriteUnlockGuard<Resource>

Constructor & Destructor Documentation

template<class T>

RWTWriteGuardBase< T >::~RWTWriteGuardBase

(

)

Destructor.

template<class T>

RWTWriteGuardBase< T >::RWTWriteGuardBase ( Resource &  resource )

protected

Constructs an instance with the given resource.

template<class T>

RWTWriteGuardBase< T >::RWTWriteGuardBase ( const RWTWriteGuardBase< Resource > &  second )

private

Copy construction prohibited.

Member Function Documentation

template<class T>

void RWTWriteGuardBase< T >::acquire

(

)

Acquires write access on the resource held by the guard unless it is already acquired. Use this function instead of directly manipulating the resource so that the guard automatically releases or acquires it, as appropriate.

template<class T>

bool RWTWriteGuardBase< T >::isAcquired

(

)

const

Returns true if the resource is currently acquired.

template<class T>

RWTWriteGuardBase<Resource>& RWTWriteGuardBase< T >::operator= ( const RWTWriteGuardBase< Resource > &  second )

private

Assignment prohibited.

template<class T>

void RWTWriteGuardBase< T >::release

(

)

Releases the resource held by the guard if it has been acquired. Use this function instead of directly manipulating the resource so that the guard automatically releases or acquires it, as appropriate.

template<class T>

Resource& RWTWriteGuardBase< T >::resource ( ) const

protected

Returns a reference to the resource currently held by the guard.