En esta página

QReadLocker Class

La clase QReadLocker es una clase auxiliar que simplifica el bloqueo y desbloqueo de bloqueos de lectura y escritura para el acceso de lectura. Más...

Encabezado: #include <QReadLocker>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son seguras para subprocesos.

Funciones públicas

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

Descripción detallada

El objetivo de QReadLocker (y de QWriteLocker) es simplificar el bloqueo y desbloqueo de QReadWriteLock. Las instrucciones de bloqueo y desbloqueo en el código de gestión de excepciones son propensas a errores y difíciles de depurar. QReadLocker se puede utilizar en tales situaciones para garantizar que el estado del bloqueo esté siempre bien definido.

A continuación se muestra un ejemplo que utiliza QReadLocker para bloquear y desbloquear un bloqueo de lectura-escritura con el fin de leer:

QReadWriteLock lock;

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

Es equivalente al siguiente código:

QReadWriteLock lock;

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

La documentación de QMutexLocker muestra ejemplos en los que el uso de un objeto «locker» simplifica enormemente la programación.

Véase también QWriteLocker y QReadWriteLock.

Documentación de funciones de miembro

QReadLocker::QReadLocker(QReadWriteLock *lock)

Crea un objeto `QReadLocker` y bloquea ` lock ` para lectura. El bloqueo se liberará cuando se destruya el objeto `QReadLocker`. Si ` lock ` es cero, `QReadLocker` no realiza ninguna acción.

Véase también QReadWriteLock::lockForRead().

[noexcept] QReadLocker::~QReadLocker()

Destruye el objeto ` QReadLocker ` y desbloquea el candado que se pasó al constructor.

Véase también QReadWriteLock::unlock().

QReadWriteLock *QReadLocker::readWriteLock() const

Devuelve un puntero al bloqueo de lectura-escritura que se pasó al constructor.

void QReadLocker::relock()

Vuelve a bloquear una cerradura desbloqueada.

Véase también unlock().

void QReadLocker::unlock()

Desbloquea el cerrojo asociado a esta taquilla.

Véase también ` QReadWriteLock::unlock()`.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.