Класс 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()

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