Класс QReadWriteLock

Класс QReadWriteLock предоставляет блокировку для чтения и записи. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются потокобезопасными.

Типы

Открытые функции

Подробное описание

Класс QReadWriteLock предоставляет блокировку для чтения и записи.

Блокировка для чтения и записи — это инструмент синхронизации для защиты ресурсов, которые могут быть доступны для чтения и записи. Этот тип блокировки полезен, если вы хотите разрешить нескольким потокам одновременный доступ только для чтения, но как только один поток захочет записать в ресурс, все другие потоки должны быть заблокированы до завершения записи.

Во многих случаях QReadWriteLock является прямым конкурентом QMutex. QReadWriteLock — хороший выбор, если есть много одновременных операций чтения, и запись происходит редко.

Пример:

QReadWriteLock lock;

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

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

Для того чтобы избежать бесконечной блокировки писателей читателями, читатели, пытающиеся получить блокировку, не будут успешны, если ожидающий писатель заблокирован, даже если блокировка в настоящее время используется только другими читателями. Также, если блокировка используется писателем и приходит другой писатель, у этого писателя будет приоритет над любыми читателями, которые могут также ожидать.

Как и QMutex, QReadWriteLock может быть рекурсивно заблокирован одним и тем же потоком, если он был создан с QReadWriteLock::Recursive в качестве QReadWriteLock::RecursionMode. В таких случаях unlock() должен быть вызван столько раз, сколько раз был вызван lockForWrite() или lockForRead(). Обратите внимание, что тип блокировки нельзя изменить при попытке рекурсивной блокировки, т.е. невозможно заблокировать для чтения в потоке, который уже заблокирован для записи (и наоборот).

См. также QReadLocker, QWriteLocker, QMutex и QSemaphore.

Документация по типам членов

перечисление QReadWriteLock::RecursionMode

Это перечисление было введено или изменено в Qt 4.4.

См. также QReadWriteLock().

Документация по функциям членов

QReadWriteLock::QReadWriteLock(RecursionMode recursionMode = NonRecursive)

Конструирует объект QReadWriteLock в заданном режиме recursionMode.

По умолчанию режим рекурсии — NonRecursive.

Эта функция была введена в Qt 4.4.

См. также lockForRead(), lockForWrite() и RecursionMode.

QReadWriteLock::~QReadWriteLock()

Уничтожает объект QReadWriteLock.

Предупреждение: Уничтожение блокировки чтения и записи, которая используется, может привести к неопределенному поведению.

void QReadWriteLock::lockForRead()

Блокирует блокировку для чтения. Эта функция заблокирует текущий поток, если другой поток заблокировал её для записи.

Невозможно заблокировать для чтения, если поток уже заблокировал её для записи.

См. также unlock(), lockForWrite() и tryLockForRead().

void QReadWriteLock::lockForWrite()

Блокирует блокировку для записи. Эта функция заблокирует текущий поток, если другой поток (включая текущий) заблокировал её для чтения или записи (если блокировка не была создана с помощью режима QReadWriteLock::Recursive).

Невозможно заблокировать для записи, если поток уже заблокировал её для чтения.

См. также unlock(), lockForRead() и tryLockForWrite().

bool QReadWriteLock::tryLockForRead()

Пытается заблокировать для чтения. Если блокировка была получена, эта функция возвращает true, в противном случае возвращает false, вместо ожидания, пока блокировка станет доступной, т.е. не блокирует.

Попытка блокировки завершится неудачно, если другой поток заблокировал её для записи.

Если блокировка была получена, её необходимо разблокировать с помощью unlock() перед тем, как другой поток сможет успешно заблокировать её для записи.

Невозможно заблокировать для чтения, если поток уже заблокировал её для записи.

См. также unlock() и lockForRead().

bool QReadWriteLock::tryLockForRead(int timeout)

Это перегруженная функция.

Пытается заблокировать для чтения. Эта функция возвращает true если блокировка была получена; в противном случае она возвращает false. Если другой поток заблокировал её для записи, эта функция будет ждать не более timeout миллисекунд, пока блокировка не станет доступной.

Примечание: Передача отрицательного числа в качестве timeout эквивалентна вызову lockForRead(), т.е. эта функция будет ждать вечно, пока блокировка не будет заблокирована для чтения, когда timeout отрицателен.

Если блокировка была получена, её необходимо разблокировать с помощью unlock() перед тем, как другой поток сможет успешно заблокировать её для записи.

Невозможно заблокировать для чтения, если поток уже заблокировал её для записи.

См. также unlock() и lockForRead().

bool QReadWriteLock::tryLockForWrite()

Пытается заблокировать для записи. Если блокировка была получена, эта функция возвращает true; в противном случае она возвращает false немедленно.

Попытка блокировки завершится неудачно, если другой поток заблокировал её для чтения или записи.

Если блокировка была получена, её необходимо разблокировать с помощью unlock() перед тем, как другой поток сможет успешно её заблокировать.

Невозможно заблокировать для записи, если поток уже заблокировал её для чтения.

См. также unlock() и lockForWrite().

bool QReadWriteLock::tryLockForWrite(int timeout)

Это перегруженная функция.

Пытается заблокировать для записи. Эта функция возвращает true если блокировка была получена; в противном случае она возвращает false. Если другой поток заблокировал её для чтения или записи, эта функция будет ждать не более timeout миллисекунд, пока блокировка не станет доступной.

Примечание: Передача отрицательного числа в качестве timeout эквивалентна вызову lockForWrite(), т.е. эта функция будет ждать вечно, пока блокировка не будет заблокирована для записи, когда timeout отрицателен.

Если блокировка была получена, её необходимо разблокировать с помощью unlock() перед тем, как другой поток сможет успешно её заблокировать.

Невозможно заблокировать для записи, если поток уже заблокировал её для чтения.

См. также unlock() и lockForWrite().

void QReadWriteLock::unlock()

Разблокирует блокировку.

Попытка разблокировать блокировку, которая не заблокирована, является ошибкой и приведет к завершению программы.

См. также lockForRead(), lockForWrite(), tryLockForRead(), и tryLockForWrite().