QReadWriteLock 类

QReadWriteLock lock;

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

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

成员函数文档

[显式构造函数] QReadWriteLock::QReadWriteLock(QReadWriteLock::递归模式 递归模式 = NonRecursive)

在给定的 递归模式 中构造 QReadWriteLock 对象。

默认递归模式是 NonRecursive。

另请参阅 lockForRead、lockForWrite 和 递归模式。

[异常不抛出] 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。

[自 6.6 版开始] bool QReadWriteLock::tryLockForRead(QDeadlineTimer timeout = {})

这是一个重载的函数。

尝试以读取方式锁定。如果成功获取锁，则此函数返回true，否则返回false。如果另一个线程已以写入方式锁定，则此函数将等待，直到超时时间到期才能获取锁。

如果获得了锁，则必须在其他线程可以成功对其进行写锁之前，使用 unlock() 对其进行解锁。

如果线程已经对锁进行了写锁，则无法对其进行读锁。

此函数在Qt 6.6版本中引入。

另请参阅 unlock 和 lockForRead。

bool QReadWriteLock::tryLockForWrite(int timeout)

尝试以写入方式锁定。如果成功获取锁，则此函数返回true，否则返回false。如果另一个线程已以读取或写入方式锁定，此函数将最多等待超时毫秒以获取锁。

注意：将负数作为超时相当于调用lockForWrite()，即当超时为负时，此函数将无限期等待，直到可以以写入方式锁定锁。

如果获取了锁，则必须在另一个线程可以成功锁定它之前使用unlock()来解锁。

如果线程已经对锁进行了读锁，则无法对其进行写锁。

另请参阅unlock() 和 lockForWrite。

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

这是一个重载的函数。

尝试以写入方式锁定。如果成功获取锁，则此函数返回true，否则返回false。如果另一个线程已以读取或写入方式锁定，则此函数将等待，直到超时时间到期才能获取锁。

如果获取了锁，则必须在另一个线程可以成功锁定它之前使用unlock()来解锁。

如果线程已经对锁进行了读锁，则无法对其进行写锁。

此函数在Qt 6.6版本中引入。

另请参阅unlock() 和 lockForWrite。

void QReadWriteLock::unlock()

解锁。

尝试解锁一个未锁定的锁是一个错误，会导致程序终止。

另请参阅lockForRead，lockForWrite，tryLockForRead，和 tryLockForWrite。