2023-01-10 14:26:54 +00:00
|
|
|
/**************************************************************************/
|
|
|
|
/* rw_lock.h */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* */
|
|
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
|
|
/* a copy of this software and associated documentation files (the */
|
|
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
|
|
/* the following conditions: */
|
|
|
|
/* */
|
|
|
|
/* The above copyright notice and this permission notice shall be */
|
|
|
|
/* included in all copies or substantial portions of the Software. */
|
|
|
|
/* */
|
|
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
|
|
/**************************************************************************/
|
2018-01-04 23:50:27 +00:00
|
|
|
|
2022-07-25 10:33:41 +00:00
|
|
|
#ifndef RW_LOCK_H
|
|
|
|
#define RW_LOCK_H
|
2017-01-07 21:25:37 +00:00
|
|
|
|
2018-09-11 16:13:45 +00:00
|
|
|
#include "core/error_list.h"
|
2017-01-07 21:25:37 +00:00
|
|
|
|
2021-01-25 18:48:38 +00:00
|
|
|
#if !defined(NO_THREADS)
|
2023-01-27 11:36:01 +00:00
|
|
|
#include "core/typedefs.h"
|
2021-01-25 18:48:38 +00:00
|
|
|
|
|
|
|
#include <shared_mutex>
|
|
|
|
|
2017-01-07 21:25:37 +00:00
|
|
|
class RWLock {
|
2021-01-25 18:48:38 +00:00
|
|
|
mutable std::shared_timed_mutex mutex;
|
2017-01-07 21:25:37 +00:00
|
|
|
|
|
|
|
public:
|
2023-01-27 11:36:01 +00:00
|
|
|
// Lock the RWLock, block if locked by someone else.
|
|
|
|
_ALWAYS_INLINE_ void read_lock() const {
|
2021-01-25 18:48:38 +00:00
|
|
|
mutex.lock_shared();
|
|
|
|
}
|
2017-01-07 21:25:37 +00:00
|
|
|
|
2023-01-27 11:36:01 +00:00
|
|
|
// Unlock the RWLock, let other threads continue.
|
|
|
|
_ALWAYS_INLINE_ void read_unlock() const {
|
2021-01-25 18:48:38 +00:00
|
|
|
mutex.unlock_shared();
|
|
|
|
}
|
2017-01-07 21:25:37 +00:00
|
|
|
|
2023-01-27 11:36:01 +00:00
|
|
|
// Attempt to lock the RWLock for reading. True on success, false means it can't lock.
|
|
|
|
_ALWAYS_INLINE_ Error read_try_lock() const {
|
2021-01-25 18:48:38 +00:00
|
|
|
return mutex.try_lock_shared() ? OK : ERR_BUSY;
|
|
|
|
}
|
|
|
|
|
2023-01-27 11:36:01 +00:00
|
|
|
// Lock the RWLock, block if locked by someone else.
|
|
|
|
_ALWAYS_INLINE_ void write_lock() {
|
2021-01-25 18:48:38 +00:00
|
|
|
mutex.lock();
|
|
|
|
}
|
|
|
|
|
2023-01-27 11:36:01 +00:00
|
|
|
// Unlock the RWLock, let other threads continue.
|
|
|
|
_ALWAYS_INLINE_ void write_unlock() {
|
2021-01-25 18:48:38 +00:00
|
|
|
mutex.unlock();
|
|
|
|
}
|
2017-01-07 21:25:37 +00:00
|
|
|
|
2023-01-27 11:36:01 +00:00
|
|
|
// Attempt to lock the RWLock for writing. True on success, false means it can't lock.
|
|
|
|
_ALWAYS_INLINE_ Error write_try_lock() {
|
2021-01-25 18:48:38 +00:00
|
|
|
return mutex.try_lock() ? OK : ERR_BUSY;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
#else
|
|
|
|
|
|
|
|
class RWLock {
|
|
|
|
public:
|
|
|
|
void read_lock() const {}
|
|
|
|
void read_unlock() const {}
|
|
|
|
Error read_try_lock() const { return OK; }
|
|
|
|
|
|
|
|
void write_lock() {}
|
|
|
|
void write_unlock() {}
|
|
|
|
Error write_try_lock() { return OK; }
|
2017-01-07 21:25:37 +00:00
|
|
|
};
|
|
|
|
|
2021-01-25 18:48:38 +00:00
|
|
|
#endif
|
|
|
|
|
2017-01-07 21:25:37 +00:00
|
|
|
class RWLockRead {
|
2021-01-25 18:48:38 +00:00
|
|
|
const RWLock &lock;
|
2017-01-07 21:25:37 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
public:
|
2023-01-27 11:36:01 +00:00
|
|
|
_ALWAYS_INLINE_ RWLockRead(const RWLock &p_lock) :
|
2021-01-25 18:48:38 +00:00
|
|
|
lock(p_lock) {
|
|
|
|
lock.read_lock();
|
2017-03-05 15:44:50 +00:00
|
|
|
}
|
2023-01-27 11:36:01 +00:00
|
|
|
_ALWAYS_INLINE_ ~RWLockRead() {
|
2021-01-25 18:48:38 +00:00
|
|
|
lock.read_unlock();
|
2017-03-05 15:44:50 +00:00
|
|
|
}
|
2017-01-07 21:25:37 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
class RWLockWrite {
|
2021-01-25 18:48:38 +00:00
|
|
|
RWLock &lock;
|
2017-01-07 21:25:37 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
public:
|
2023-01-27 11:36:01 +00:00
|
|
|
_ALWAYS_INLINE_ RWLockWrite(RWLock &p_lock) :
|
2021-01-25 18:48:38 +00:00
|
|
|
lock(p_lock) {
|
|
|
|
lock.write_lock();
|
2017-03-05 15:44:50 +00:00
|
|
|
}
|
2023-01-27 11:36:01 +00:00
|
|
|
_ALWAYS_INLINE_ ~RWLockWrite() {
|
2021-01-25 18:48:38 +00:00
|
|
|
lock.write_unlock();
|
2017-03-05 15:44:50 +00:00
|
|
|
}
|
2017-01-07 21:25:37 +00:00
|
|
|
};
|
|
|
|
|
2022-07-25 10:33:41 +00:00
|
|
|
#endif // RW_LOCK_H
|