QReadWriteLock Class

QReadWriteLock lock;

void ReaderThread::run()
{
    //...
    lock.lockForRead();
    read_file();
    lock.unlock();
    //...
}

void WriterThread::run()
{
    //...
    lock.lockForWrite();
    write_file();
    lock.unlock();
    //...
}

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

[explicit] QReadWriteLock::QReadWriteLock(QReadWriteLock::RecursionMode recursionMode = NonRecursive)

指定されたrecursionMode でQReadWriteLockオブジェクトを生成します。

デフォルトの再帰モードはNonRecursive です。

lockForRead()、lockForWrite()、およびRecursionModeも参照してください 。

[noexcept] QReadWriteLock::~QReadWriteLock()

QReadWriteLock オブジェクトを破棄します。

void QReadWriteLock::lockForRead()

ロックを読み取り用にロックします。別のスレッドが書き込み用にロックしている場合、この関数は現在のスレッドをブロックします。

スレッドがすでに書き込み用にロックしている場合、読み取り用にロックすることはできません。

unlock()、lockForWrite()、およびtryLockForRead()も参照してください 。

void QReadWriteLock::lockForWrite()

ロックを書き込み用にロックします。この関数は、別のスレッド（現在のスレッドを含む）が読み取りまたは書き込み用にロックしている場合、現在のスレッドをブロックします（QReadWriteLock::Recursive モードを使用してロックが作成されている場合は除く）。

スレッドがすでに読み取り用にロックされている場合、書き込み用にロックすることはできません。

unlock()、lockForRead()、およびtryLockForWrite()も参照してください 。

bool QReadWriteLock::tryLockForRead(int timeout)

読み取り用ロックの取得を試みます。この関数は、ロックが取得できた場合にtrue を返し、そうでない場合はfalse を返します。別のスレッドが書き込み用ロックを取得している場合、この関数はロックが解放されるまで最大timeout ミリ秒待機します。

注：timeout として負の数を渡すことは、lockForRead() を呼び出すことと同じです。つまり、timeout が負の場合、この関数はロックが読み取り用にロック可能になるまで無限に待機します。

ロックが取得された場合、別のスレッドが書き込み用にロックを正常に取得するには、unlock() を使用してロックを解除する必要があります。

スレッドがすでに書き込み用にロックしている場合、読み取り用にロックすることはできません。

unlock() およびlockForRead()も参照してください 。

[since 6.6] bool QReadWriteLock::tryLockForRead(QDeadlineTimer timeout = {})

読み取り用ロックを取得しようと試みます。この関数は、ロックが取得できた場合はtrue を返し、そうでない場合はfalse を返します。別のスレッドが書き込み用ロックを取得している場合、この関数はtimeout が期限切れになり、ロックが利用可能になるまで待機します。

ロックが取得された場合、別のスレッドが書き込み用にロックを正常に取得するには、事前にunlock() を使用してロックを解除する必要があります。

スレッドがすでに書き込み用にロックしている場合、読み取り用にロックすることはできません。

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

unlock() およびlockForRead()も参照してください 。

bool QReadWriteLock::tryLockForWrite(int timeout)

書き込み用ロックの取得を試みます。この関数は、ロックを取得できた場合にtrue を返し、そうでない場合はfalse を返します。別のスレッドが読み取りまたは書き込み用にロックしている場合、この関数はロックが解放されるまで最大timeout ミリ秒待機します。

注：timeout として負の数を渡すことは、lockForWrite()を呼び出すことと同等です。つまり、timeout が負の場合、この関数は書き込み用ロックが取得可能になるまで無限に待機します。

ロックが取得された場合、別のスレッドが正常にロックを行うには、unlock() を使用してロックを解除する必要があります。

スレッドがすでに読み取り用ロックを取得している場合、書き込み用ロックを取得することはできません。

unlock() およびlockForWrite()も参照してください 。

[since 6.6] bool QReadWriteLock::tryLockForWrite(QDeadlineTimer timeout = {})

書き込み用ロックを取得しようとします。この関数は、ロックを取得できた場合にtrue を返し、そうでない場合はfalse を返します。別のスレッドが読み取り用または書き込み用のロックを取得している場合、この関数はtimeout が期限切れになり、ロックが利用可能になるまで待機します。

ロックが取得された場合、別のスレッドが正常にロックを取得するには、unlock() を使用してロックを解除する必要があります。

スレッドがすでに読み取り用にロックしている場合、書き込み用にロックすることはできません。

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

unlock() およびlockForWrite()も参照してください 。

void QReadWriteLock::unlock()

ロックを解除します。

ロックされていないロックを解除しようとするとエラーとなり、プログラムが終了します。

lockForRead()、lockForWrite()、tryLockForRead()、およびtryLockForWrite()も参照してください 。