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