This class template implements a guard for tentative acquisition and release of synchronization resources (i.e., locks).

Synopsis

Declared in <bslmt_lockguard.h>

template<class T>
class LockGuardTryLock;

Member Functions

Name

Description

LockGuardTryLock [constructor]

Create a scoped guard that conditionally manages the specified lock (if non‐null) and invokes lock‐>tryLock() until the lock is acquired, or until the optionally specified attempts have been made to acquire the lock. If attempts is not specified only one attempt is made to acquire the lock. Supplying a null lock has no effect. The behavior is undefined unless lock (if non‐null) is not already locked by this thread and 0 < attempts. Note that lock must remain valid throughout the lifetime of this guard, or until release is called.

~LockGuardTryLock [destructor]

Destroy this scoped guard and invoke the unlock method on the lock object under management by this guard, if any. If no lock is currently being managed, this method has no effect.

ptr

Return the address of the modifiable lock object under management by this guard, or 0 if no lock is currently being managed.

release

Return the address of the modifiable lock object under management by this guard, and release the lock from further management by this guard. If no lock is currently being managed, return 0 with no other effect. Note that this operation does not unlock the lock object (if any) that was under management.

Derived Classes

Name

Description

TryLockGuard

DEPRECATED: Use LockGuardTryLock instead.

Created with MrDocs