RWTUnlockGuard<Resource>

Threads Module Reference Guide
Rogue Wave web site: Home Page | Main Documentation Page

RWTUnlockGuard<Resource>

Module: Threads Package: Synchronization


RWTUnlockGuard<Resource>   RWTGuardBase<Resource>

Local Index
Header File
Description
Example
Public Typedef
Public Constructor
Public Destructor
Private Constructor
Private Member Operator
See Also

Local Index

Members

operator=()

ResourceType

RWTUnlockGuard()

~RWTUnlockGuard()

Header File

#include <rw/sync/RWTUnlockGuard.h>

Description

RWTUnlockGuard<Resource> is a guard class that releases its resource upon creation and acquires it upon destruction. 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 release a mutex upon creation and reacquire it when destructed. The class used as the actual template parameter for Resource must be one that provides acquire and release methods such as the synchronization classes provided in this module.

Example

#include <rw/sync/RWMutexLock.h>
#include <rw/sync/RWTUnlockGuard.h>


// ...
RWMutexLock mutex;

void foo()
{
   mutex.acquire();

   // ... critical code

   // temporarily release mutex for the duration of block:
   {  
      RWTUnlockGuard<RWMutexLock> lock(mutex); // releases mutex
   
      // ... anti-critical section

      // Mutex will be reacquired in RWTUnlockGuard destructor.
   }

   // ... more critical code

   mutex.release();
}

Public Typedef

typedef Resource     ResourceType;

Public Constructor

RWTUnlockGuard(Resource& resource);

Releases the resource.

Public Destructor

~RWTUnlockGuard();

Reacquires the resource.

Private Constructor

RWTUnlockGuard(const RWTUnlockGuard<Resource>& second);

Copy construction prohibited.

Private Member Operator

RWTUnlockGuard<Resource>&
operator=(const RWTUnlockGuard<Resource>& second);

Assignment prohibited.