Класс QWriteLocker

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

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

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

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

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

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

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

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

Вот пример, который использует QWriteLocker для блокировки и разблокировки мьютекса для записи:

QReadWriteLock lock;

void writeData(const QByteArray &data)
{
    QWriteLocker locker(&lock);
    ...
}

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

QReadWriteLock lock;

void writeData(const QByteArray &data)
{
    lock.lockForWrite();
    ...
    lock.unlock();
}

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

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

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

QWriteLocker::QWriteLocker(QReadWriteLock **lock*)

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

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

QWriteLocker::~QWriteLocker()

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

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

QReadWriteLock *QWriteLocker::readWriteLock() const

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

void QWriteLocker::relock()

Переблокирует разблокированный мьютекс.

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

void QWriteLocker::unlock()

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