added locker classes intended to be used with QMutex

CMakeLists.txt

@@ -8,6 +8,8 @@ set(HEADER_FILES
     misc/desktoputils.h
     misc/xmlparsermacros.h
     misc/undefxmlparsermacros.h
+    misc/trylocker.h
+    misc/adoptlocker.h
     models/checklistmodel.h
     resources/qtconfigarguments.h
     resources/resources.h

misc/adoptlocker.h

@@ -0,0 +1,38 @@
+#ifndef ADOPTLOCKER_H
+#define ADOPTLOCKER_H
+
+#include <QtGlobal>
+
+QT_FORWARD_DECLARE_CLASS(QMutex)
+
+namespace ThreadingUtils {
+
+/*!
+ * \brief Like QMutexLocker, but assumes that the mutex has already been locked.
+ */
+template<typename Mutex = QMutex>
+class AdoptLocker
+{
+public:
+    /*!
+     * \brief Constructs the locker for the specified \a mutex.
+     */
+    AdoptLocker(Mutex &mutex) :
+        m_mutex(mutex)
+    {}
+
+    /*!
+     * \brief Unlocks the mutex specified when constructing the instance.
+     */
+    ~AdoptLocker()
+    {
+        m_mutex.unlock();
+    }
+
+private:
+    Mutex &m_mutex;
+};
+
+}
+
+#endif // ADOPTLOCKER_H

misc/trylocker.h

@@ -0,0 +1,57 @@
+#ifndef TRYLOCKER_H
+#define TRYLOCKER_H
+
+#include <QtGlobal>
+
+QT_FORWARD_DECLARE_CLASS(QMutex)
+
+namespace ThreadingUtils {
+
+/*!
+ * \brief Like QMutexLocker, but it just tries to lock the mutex.
+ */
+template<typename Mutex = QMutex>
+class TryLocker
+{
+public:
+    /*!
+     * \brief Tries to lock the specified mutex.
+     */
+    TryLocker(Mutex &mutex) :
+        m_mutex(mutex.tryLock() ? &mutex : nullptr)
+    {}
+
+    /*!
+     * \brief Unlocks the mutex specified when constructing.
+     * \remarks Does nothing if the mutex couldn't be locked in the first place.
+     */
+    ~TryLocker()
+    {
+        if(m_mutex) {
+            m_mutex->unlock();
+        }
+    }
+
+    /*!
+     * \brief Returns whether the mutex could be locked.
+     */
+    bool isLocked() const
+    {
+        return m_mutex != nullptr;
+    }
+
+    /*!
+     * \brief Returns whether the mutex could be locked.
+     */
+    operator bool() const
+    {
+        return m_mutex != nullptr;
+    }
+
+private:
+    Mutex *m_mutex;
+};
+
+}
+
+#endif // TRYLOCKER_H

qtutilities.pro

@@ -32,7 +32,9 @@ HEADERS += \
     misc/dialogutils.h \
     misc/desktoputils.h \
     misc/xmlparsermacros.h \
-    misc/undefxmlparsermacros.h
+    misc/undefxmlparsermacros.h \
+    misc/trylocker.h \
+    misc/adoptlocker.h
 
 SOURCES += resources/resources.cpp \
     models/checklistmodel.cpp \