85 lines
2.7 KiB
C
85 lines
2.7 KiB
C
|
/*
|
||
|
|
==============================================================================
|
||
|
|
|
||
|
|
This file is part of the JUCE library.
|
||
|
|
Copyright (c) 2017 - ROLI Ltd.
|
||
|
|
|
||
|
|
JUCE is an open source library subject to commercial or open-source
|
||
|
|
licensing.
|
||
|
|
|
||
|
|
The code included in this file is provided under the terms of the ISC license
|
||
|
|
http://www.isc.org/downloads/software-support-policy/isc-license. Permission
|
||
|
|
To use, copy, modify, and/or distribute this software for any purpose with or
|
||
|
|
without fee is hereby granted provided that the above copyright notice and
|
||
|
|
this permission notice appear in all copies.
|
||
|
|
|
||
|
|
JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
|
||
|
|
EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
|
||
|
|
DISCLAIMED.
|
||
|
|
|
||
|
|
==============================================================================
|
||
|
|
*/
|
||
|
|
|
||
|
|
namespace juce
|
||
|
|
{
|
||
|
|
|
||
|
|
//==============================================================================
|
||
|
|
/**
|
||
|
|
Automatically locks and unlocks a ReadWriteLock object.
|
||
|
|
|
||
|
|
Use one of these as a local variable to control access to a ReadWriteLock.
|
||
|
|
|
||
|
|
e.g. @code
|
||
|
|
|
||
|
|
ReadWriteLock myLock;
|
||
|
|
|
||
|
|
for (;;)
|
||
|
|
{
|
||
|
|
const ScopedWriteLock myScopedLock (myLock);
|
||
|
|
// myLock is now locked
|
||
|
|
|
||
|
|
...do some stuff...
|
||
|
|
|
||
|
|
// myLock gets unlocked here.
|
||
|
|
}
|
||
|
|
@endcode
|
||
|
|
|
||
|
|
@see ReadWriteLock, ScopedReadLock
|
||
|
|
|
||
|
|
@tags{Core}
|
||
|
|
*/
|
||
|
|
class JUCE_API ScopedWriteLock
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
//==============================================================================
|
||
|
|
/** Creates a ScopedWriteLock.
|
||
|
|
|
||
|
|
As soon as it is created, this will call ReadWriteLock::enterWrite(), and
|
||
|
|
when the ScopedWriteLock object is deleted, the ReadWriteLock will
|
||
|
|
be unlocked.
|
||
|
|
|
||
|
|
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.
|
||
|
|
*/
|
||
|
|
inline explicit ScopedWriteLock (const ReadWriteLock& lock) noexcept : lock_ (lock) { lock.enterWrite(); }
|
||
|
|
|
||
|
|
/** Destructor.
|
||
|
|
|
||
|
|
The ReadWriteLock's exitWrite() method will be called 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!
|
||
|
|
*/
|
||
|
|
inline ~ScopedWriteLock() noexcept { lock_.exitWrite(); }
|
||
|
|
|
||
|
|
|
||
|
|
private:
|
||
|
|
//==============================================================================
|
||
|
|
const ReadWriteLock& lock_;
|
||
|
|
|
||
|
|
JUCE_DECLARE_NON_COPYABLE (ScopedWriteLock)
|
||
|
|
};
|
||
|
|
|
||
|
|
}
|