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()。