RWTReadUnlockGuard< Resource > Class Template Reference
[Synchronization]

A guard class that releases its resource upon creation and acquires read access to its resource upon destruction. More...

#include <rw/sync/RWTReadUnlockGuard.h>

Inheritance diagram for RWTReadUnlockGuard< Resource >:

List of all members.

Public Member Functions
	RWTReadUnlockGuard (Resource &resource)
	~RWTReadUnlockGuard ()
Private Member Functions
	RWTReadUnlockGuard (const RWTReadUnlockGuard< Resource > &second)
RWTReadUnlockGuard< Resource > &	operator= (const RWTReadUnlockGuard< Resource > &second)

---

Detailed Description

template<class Resource>
class RWTReadUnlockGuard< Resource >

RWTReadUnlockGuard<Resource> is a guard class that releases its resource upon creation and acquires read access to its resource upon destruction. Guard objects work in conjunction with block statements. The guard objects 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 release read access on a mutex upon creation and reacquire read access on that mutex when destructed. The class used as the template parameter Resource must be one that provides acquireRead() and release() methods, such as the synchronization classes provided in this module.

Examples

 #include <rw/sync/RWReadersWriterLock.h>
 #include <rw/sync/RWTReadUnlockGuard.h>

 // ...
 RWReadersWriterLock rwlock;

 void foo()
 {
    rwlock.acquireRead();
    // ... critical code

    // temporarily release readers-writer lock
    // for duration of block:
    {
       // constructor releases lock:
       RWTReadUnlockGuard<RWReadersWriterLock> lock(rwlock);

       // ... anti-critical section
       // lock will be reacquired for reading in
       //   RWTReadUnlockGuard destructor.
    }
    // ... more critical code
    rwlock.release();
 }

See also:

RWTReadLockGuard<Resource> RWTTryReadLockGuard<Resource>

---

Constructor & Destructor Documentation

template<class Resource >

RWTReadUnlockGuard< Resource >::RWTReadUnlockGuard

(

Resource &

resource

)

[inline]

Releases the resource.

template<class Resource >

RWTReadUnlockGuard< Resource >::~RWTReadUnlockGuard

(

)

[inline]

Reacquires read access on the resource.

template<class Resource>

RWTReadUnlockGuard< Resource >::RWTReadUnlockGuard

(

const RWTReadUnlockGuard< Resource > &

second

)

[private]

Copy construction prohibited.

---

Member Function Documentation

template<class Resource>

RWTReadUnlockGuard<Resource>& RWTReadUnlockGuard< Resource >::operator=

(

const RWTReadUnlockGuard< Resource > &

second

)

[private]

Assignment prohibited.