rwlogo
SourcePro 11.1

SourcePro® C++ API Reference Guide



   SourcePro C++
Documentation Home

RWTWriteGuardBase< Resource > Class Template Reference
[Synchronization]

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

#include <rw/sync/RWTWriteGuardBase.h>

Inheritance diagram for RWTWriteGuardBase< Resource >:
RWTWriteLockGuardBase< Resource > RWTWriteUnlockGuard< Resource > RWTTryWriteLockGuard< Resource > RWTWriteLockGuard< Resource >

List of all members.

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 Resource>
class RWTWriteGuardBase< Resource >

RWTWriteGuardBase<Resource> is intended as 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 in such a way as 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 upon creation and release it when destructed. The class used as the actual template parameter for Resource must be one that provides acquireWrite and release methods (such as the synchronization classes provided in this module).

See also:
RWTWriteLockGuardBase<Resource> RWTWriteLockGuard<Resource> RWTWriteUnlockGuard<Resource>

Constructor & Destructor Documentation

template<class Resource >
RWTWriteGuardBase< Resource >::~RWTWriteGuardBase (  )  [inline]

Destructor.

template<class Resource >
RWTWriteGuardBase< Resource >::RWTWriteGuardBase ( Resource &  resource  )  [inline, protected]

Constructs an instance with the given resource.

template<class Resource >
RWTWriteGuardBase< Resource >::RWTWriteGuardBase ( const RWTWriteGuardBase< Resource > &  second  )  [private]

Copy construction prohibited.


Member Function Documentation

template<class Resource >
void RWTWriteGuardBase< Resource >::acquire ( void   )  [inline]

Acquires write access on the resource held by the guard unless it is already acquired. Uses this function instead of directly manipulating the resource so that the guard will automatically release or acquire it (as appropriate).

template<class Resource >
bool RWTWriteGuardBase< Resource >::isAcquired (  )  const [inline]

Returns true if the resource is currently acquired.

template<class Resource >
RWTWriteGuardBase<Resource>& RWTWriteGuardBase< Resource >::operator= ( const RWTWriteGuardBase< Resource > &  second  )  [private]

Assignment prohibited.

template<class Resource >
void RWTWriteGuardBase< Resource >::release ( void   )  [inline]

Releases the resource held by the guard if it has been acquired. Uses this function instead of directly manipulating the resource so that the guard will automatically release or acquire it (as appropriate).

template<class Resource >
Resource & RWTWriteGuardBase< Resource >::resource (  )  const [inline, protected]

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


© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.