QMutexLocker Class

int complexFunction(int flag)
{
    mutex.lock();

    int retVal = 0;

    switch (flag) {
    case 0:
    case 1:
        retVal = moreComplexFunction(flag);
        break;
    case 2:
        {
            int status = anotherFunction();
            if (status < 0) {
                mutex.unlock();
                return -2;
            }
            retVal = status + flag;
        }
        break;
    default:
        if (flag > 10) {
            mutex.unlock();
            return -1;
        }
        break;
    }

    mutex.unlock();
    return retVal;
}

int complexFunction(int flag)
{
    QMutexLocker locker(&mutex);

    int retVal = 0;

    switch (flag) {
    case 0:
    case 1:
        return moreComplexFunction(flag);
    case 2:
        {
            int status = anotherFunction();
            if (status < 0)
                return -2;
            retVal = status + flag;
        }
        break;
    default:
        if (flag > 10)
            return -1;
        break;
    }

    return retVal;
}

class SignalWaiter
{
private:
    QMutexLocker<QMutex> locker;

public:
    SignalWaiter(QMutex *mutex)
        : locker(mutex)
    {
    }

    void waitForSignal()
    {
        //...
        while (!signalled)
            waitCondition.wait(locker.mutex());
        //...
    }
};

メンバ関数のドキュメント

[explicit noexcept(...)] QMutexLocker::QMutexLocker(Mutex *mutex)

QMutexLocker を作成し、mutex をロックします。QMutexLocker が破棄されると、ミューテックスはロック解除されます。mutex がnullptr の場合、QMutexLocker は何も行いません。

QMutex::lock()も参照してください 。

[noexcept, since 6.4] QMutexLocker::QMutexLocker(QMutexLocker<Mutex> &&other)

other から QMutexLocker を移動構築します。ミューテックスおよびother の状態は、新しく構築されたインスタンスに引き継がれます。移動後、other はミューテックスを一切管理しなくなります。

この関数は Qt 6.4 で導入されました。

QMutex::lock()も参照してください 。

QMutexLocker::~QMutexLocker()

QMutexLocker を破棄し、コンストラクタでロックされていたミューテックスを解除します。

QMutex::unlock()も参照してください 。

[noexcept, since 6.4] bool QMutexLocker::isLocked() const

このQMutexLocker が現在、関連付けられたミューテックスをロックしている場合はtrueを返し、そうでない場合はfalseを返します。

この関数は Qt 6.4 で導入されました。

Mutex *QMutexLocker::mutex() const

QMutexLocker が操作対象としているミューテックスを返します。

[noexcept(...)] void QMutexLocker::relock()

ロックが解除されたミューテックス・ロッカーを再ロックします。

unlock()も参照してください 。

[noexcept, since 6.4] void QMutexLocker::swap(QMutexLocker<Mutex> &other)

このQMutexLocker のミューテックスと状態を、other と入れ替えます。この操作は非常に高速で、失敗することはありません。

この関数は Qt 6.4 で導入されました。

QMutex::lock()も参照してください 。

[noexcept] void QMutexLocker::unlock()

このミューテックス・ロッカーのロックを解除します。relock() を使用して、再度ロックすることができます。破棄する際にはロックする必要はありません。

relock()も参照してください 。

[noexcept, since 6.4] QMutexLocker<Mutex> &QMutexLocker::operator=(QMutexLocker<Mutex> &&other)

other をこのQMutexLocker に移動代入します。もしこのQMutexLocker が代入前にロックされたミューテックスを保持していた場合、そのミューテックスはロックが解除されます。その後、ミューテックスとother の状態は、このQMutexLocker に移管されます。移動後、other はもはやいかなるミューテックスも管理しなくなります。

この関数は Qt 6.4 で導入されました。

QMutex::lock()も参照してください 。