En esta página

QReadWriteLock Class

La clase QReadWriteLock permite el bloqueo de lectura y escritura. Más información...

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

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

Tipos públicos

enum RecursionMode { Recursive, NonRecursive }

Funciones públicas

QReadWriteLock(QReadWriteLock::RecursionMode recursionMode = NonRecursive)
~QReadWriteLock()
void lockForRead()
void lockForWrite()
bool tryLockForRead(int timeout)
(since 6.6) bool tryLockForRead(QDeadlineTimer timeout = {})
bool tryLockForWrite(int timeout)
(since 6.6) bool tryLockForWrite(QDeadlineTimer timeout = {})
void unlock()

Descripción detallada

Un bloqueo de lectura-escritura es una herramienta de sincronización destinada a proteger recursos a los que se puede acceder tanto para leer como para escribir. Este tipo de bloqueo resulta útil si se desea permitir que varios subprocesos tengan acceso simultáneo de solo lectura, pero, en cuanto un subproceso quiera escribir en el recurso, todos los demás subprocesos deben bloquearse hasta que finalice la operación de escritura.

En muchos casos, `QReadWriteLock` es un competidor directo de ` QMutex`. `QReadWriteLock` es una buena opción si hay muchas lecturas simultáneas y las escrituras se producen con poca frecuencia.

Ejemplo:

QReadWriteLock lock;

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

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

Para garantizar que los escritores no queden bloqueados indefinidamente por los lectores, los lectores que intenten obtener un bloqueo no lo conseguirán si hay un escritor bloqueado esperando acceso, incluso si en ese momento solo otros lectores tienen acceso al bloqueo. Además, si un escritor tiene acceso al bloqueo y entra otro escritor, este último tendrá prioridad sobre cualquier lector que también pueda estar esperando.

Al igual que QMutex, un QReadWriteLock puede bloquearse de forma recursiva por el mismo hilo cuando se crea con QReadWriteLock::Recursive como QReadWriteLock::RecursionMode. En tales casos, unlock() debe llamarse el mismo número de veces que se ha llamado a lockForWrite() o lockForRead(). Ten en cuenta que el tipo de bloqueo no se puede cambiar al intentar bloquear de forma recursiva, es decir, no es posible bloquear para lectura en un hilo que ya se haya bloqueado para escritura (y viceversa).

Véase también QReadLocker, QWriteLocker, QMutex y QSemaphore.

Documentación sobre los tipos de miembros

enum QReadWriteLock::RecursionMode

ConstanteValorDescripción
QReadWriteLock::Recursive1En este modo, un hilo puede bloquear el mismo ` QReadWriteLock ` varias veces. El ` QReadWriteLock ` no se desbloqueará hasta que se haya realizado el número correspondiente de llamadas a ` unlock()`.
QReadWriteLock::NonRecursive0En este modo, un hilo solo puede bloquear un ` QReadWriteLock ` una vez.

Véase también QReadWriteLock().

Documentación de funciones de miembro

[explicit] QReadWriteLock::QReadWriteLock(QReadWriteLock::RecursionMode recursionMode = NonRecursive)

Crea un objeto QReadWriteLock en el ` recursionMode` indicado.

El modo de recursión predeterminado es « NonRecursive ».

Véase también lockForRead(), lockForWrite() y RecursionMode.

[noexcept] QReadWriteLock::~QReadWriteLock()

Destruye el objeto « QReadWriteLock ».

Advertencia: La eliminación de un bloqueo de lectura y escritura que se está utilizando puede provocar un comportamiento indefinido.

void QReadWriteLock::lockForRead()

Bloquea el candado para lectura. Esta función bloqueará el hilo actual si otro hilo ha bloqueado el candado para escritura.

No es posible bloquear para lectura si el hilo ya ha bloqueado para escritura.

Véase también unlock(), lockForWrite() y tryLockForRead().

void QReadWriteLock::lockForWrite()

Bloquea el bloqueo para escritura. Esta función bloqueará el hilo actual si otro hilo (incluido el actual) ha bloqueado para lectura o escritura (a menos que el bloqueo se haya creado utilizando el modo « QReadWriteLock::Recursive »).

No es posible bloquear para escritura si el hilo ya ha bloqueado para lectura.

Véase también unlock(), lockForRead() y tryLockForWrite().

bool QReadWriteLock::tryLockForRead(int timeout)

Intenta obtener un bloqueo de lectura. Esta función devuelve ` true ` si se ha obtenido el bloqueo; en caso contrario, devuelve ` false`. Si otro hilo ha obtenido un bloqueo de escritura, esta función esperará como máximo ` timeout ` milisegundos a que el bloqueo quede disponible.

Nota: Pasar un número negativo como timeout equivale a llamar a lockForRead(), es decir, esta función esperará indefinidamente hasta que se pueda bloquear para lectura cuando timeout sea negativo.

Si se ha obtenido el bloqueo, este debe desbloquearse con unlock() antes de que otro hilo pueda bloquearlo correctamente para escritura.

No es posible bloquear en lectura si el hilo ya lo ha bloqueado en escritura.

Véanse también unlock() y lockForRead().

[since 6.6] bool QReadWriteLock::tryLockForRead(QDeadlineTimer timeout = {})

Intenta obtener un bloqueo de lectura. Esta función devuelve ` true ` si se ha obtenido el bloqueo; en caso contrario, devuelve ` false`. Si otro hilo ha obtenido un bloqueo de escritura, esta función esperará hasta que caduque ` timeout ` para que el bloqueo quede disponible.

Si se ha obtenido el bloqueo, este debe desbloquearse con unlock() antes de que otro hilo pueda bloquearlo correctamente para escritura.

No es posible bloquear para lectura si el hilo ya se ha bloqueado para escritura.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.6.

Véanse también unlock() y lockForRead().

bool QReadWriteLock::tryLockForWrite(int timeout)

Intenta obtener un bloqueo de escritura. Esta función devuelve ` true ` si se ha obtenido el bloqueo; en caso contrario, devuelve ` false`. Si otro hilo ha obtenido un bloqueo de lectura o de escritura, esta función esperará como máximo ` timeout ` milisegundos a que el bloqueo quede disponible.

Nota: Pasar un número negativo como timeout equivale a llamar a lockForWrite(), es decir, esta función esperará indefinidamente hasta que se pueda bloquear para escritura cuando timeout sea negativo.

Si se ha obtenido el bloqueo, este debe desbloquearse con unlock() antes de que otro hilo pueda bloquearlo correctamente.

No es posible bloquear para escritura si el hilo ya lo ha bloqueado para lectura.

Véase también unlock() y lockForWrite().

[since 6.6] bool QReadWriteLock::tryLockForWrite(QDeadlineTimer timeout = {})

Intenta obtener un bloqueo de escritura. Esta función devuelve ` true ` si se ha obtenido el bloqueo; en caso contrario, devuelve ` false`. Si otro hilo ha obtenido un bloqueo de lectura o de escritura, esta función esperará hasta que expire ` timeout ` para que el bloqueo quede disponible.

Si se ha obtenido el bloqueo, este debe desbloquearse con ` unlock()` antes de que otro hilo pueda bloquearlo correctamente.

No es posible bloquear para escritura si el hilo ya lo ha bloqueado para lectura.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.6.

Véanse también unlock() y lockForWrite().

void QReadWriteLock::unlock()

Desbloquea la cerradura.

Intentar desbloquear un candado que no está bloqueado es un error y provocará la finalización del programa.

Véase también lockForRead(), lockForWrite(), tryLockForRead() y tryLockForWrite().

© 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.