Класс QReadLocker

Класс QReadLocker — это вспомогательный класс, который упрощает блокировку и разблокировку мьютексов чтения-записи для чтения. Подробнее...

Заголовок:	#include <QReadLocker>
CMake:	find_package(Qt6 COMPONENTS Core REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake:	QT += core

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

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

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

	QReadLocker(QReadWriteLock *lock)
	~QReadLocker()
QReadWriteLock *	readWriteLock() const
void	relock()
void	unlock()

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

Цель QReadLocker (и QWriteLocker) — упростить блокировку и разблокировку QReadWriteLock. Блокировка и разблокировка в операторах или обработчиках исключений подвержена ошибкам и трудна для отладки. QReadLocker можно использовать в таких ситуациях, чтобы гарантировать, что состояние блокировки всегда определено.

Вот пример, использующий QReadLocker для блокировки и разблокировки мьютекса чтения-записи для чтения:

QReadWriteLock lock;

QByteArray readData()
{
    QReadLocker locker(&lock);
    ...
    return data;
}

Это эквивалентно следующему коду:

QReadWriteLock lock;

QByteArray readData()
{
    lock.lockForRead();
    ...
    lock.unlock();
    return data;
}

Документация QMutexLocker содержит примеры, где использование объекта блокировки значительно упрощает программирование.

См. также QWriteLocker и QReadWriteLock.

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

QReadLocker::QReadLocker(QReadWriteLock **lock*)

Создает QReadLocker и блокирует lock для чтения. Блокировка будет разблокирована при уничтожении QReadLocker. Если lock равно нулю, QReadLocker ничего не делает.

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

QReadLocker::~QReadLocker()

Уничтожает QReadLocker и разблокирует блокировку, переданную в конструктор.

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

QReadWriteLock *QReadLocker::readWriteLock() const

Возвращает указатель на мьютекс чтения-записи, переданный в конструктор.

void QReadLocker::relock()

Переблокирует разблокированную блокировку.

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

void QReadLocker::unlock()

Разблокирует блокировку, связанную с этой блокировкой.