JUCE  v5.1.1-3-g1a0b28c73
JUCE API
GenericScopedUnlock< LockType > Class Template Reference

Automatically unlocks and re-locks a mutex object. More...

#include <juce_ScopedLock.h>

Collaboration diagram for GenericScopedUnlock< LockType >:

Public Member Functions

 GenericScopedUnlock (const LockType &lock) noexcept
 Creates a GenericScopedUnlock. More...
 
 ~GenericScopedUnlock () noexcept
 Destructor. More...
 

Private Attributes

const LockType & lock_
 

Detailed Description

template<class LockType>
class GenericScopedUnlock< LockType >

Automatically unlocks and re-locks a mutex object.

This is the reverse of a GenericScopedLock object - instead of locking the mutex for the lifetime of this object, it unlocks it.

Make sure you don't try to unlock mutexes that aren't actually locked!

e.g.

CriticalSection myCriticalSection;
for (;;)
{
const GenericScopedLock<CriticalSection> myScopedLock (myCriticalSection);
// myCriticalSection is now locked
... do some stuff with it locked ..
while (xyz)
{
... do some stuff with it locked ..
const GenericScopedUnlock<CriticalSection> unlocker (myCriticalSection);
// myCriticalSection is now unlocked for the remainder of this block,
// and re-locked at the end.
...do some stuff with it unlocked ...
}
// myCriticalSection gets unlocked here.
}
See also
GenericScopedLock, CriticalSection, ScopedLock, ScopedUnlock

Constructor & Destructor Documentation

◆ GenericScopedUnlock()

template<class LockType>
GenericScopedUnlock< LockType >::GenericScopedUnlock ( const LockType &  lock)
inlineexplicitnoexcept

Creates a GenericScopedUnlock.

As soon as it is created, this will unlock the CriticalSection, and when the ScopedLock object is deleted, the CriticalSection will be re-locked.

Make sure this object is created and deleted by the same thread, otherwise there are no guarantees what will happen! Best just to use it as a local stack object, rather than creating one with the new() operator.

◆ ~GenericScopedUnlock()

template<class LockType>
GenericScopedUnlock< LockType >::~GenericScopedUnlock ( )
inlinenoexcept

Destructor.

The CriticalSection will be unlocked when the destructor is called.

Make sure this object is created and deleted by the same thread, otherwise there are no guarantees what will happen!

References GenericScopedLock< LockType >::lock_.

Member Data Documentation

◆ lock_

template<class LockType>
const LockType& GenericScopedUnlock< LockType >::lock_
private

The documentation for this class was generated from the following file: