En esta página

QRecursiveMutex Class

La clase QRecursiveMutex permite la serialización del acceso entre subprocesos. Más información...

Encabezado: #include <QRecursiveMutex>
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

QRecursiveMutex()
~QRecursiveMutex()
void lock()
(since 6.6) bool tryLock(QDeadlineTimer timeout = {})
bool tryLock(int timeout)
bool try_lock()
bool try_lock_for(std::chrono::duration<Rep, Period> duration)
bool try_lock_until(std::chrono::time_point<Clock, Duration> timePoint)
void unlock()

Descripción detallada

La clase QRecursiveMutex es un mutex, al igual que QMutex, con el que es compatible a nivel de API. Se diferencia de QMutex en que acepta llamadas a lock() desde el mismo hilo tantas veces como sea necesario. QMutex entraría en interbloqueo en esta situación.

QRecursiveMutex es mucho más costoso de crear y manejar, por lo que conviene utilizar un QMutex sencillo siempre que sea posible. Sin embargo, a veces una función pública llama a otra función pública y ambas necesitan bloquear el mismo mutex. En este caso, tienes dos opciones:

  • Descomponer el código que necesita protección mediante un mutex en funciones privadas, que asumen que el mutex está bloqueado cuando se llaman, y bloquear un QMutex sencillo en las funciones públicas antes de llamar a las funciones de implementación privadas.
  • O bien, utiliza un mutex recursivo, de modo que no importe que la primera función pública ya haya bloqueado el mutex cuando la segunda quiera hacerlo.

Véase también QMutex, QMutexLocker, QReadWriteLock, QSemaphore y QWaitCondition.

Documentación de las funciones miembro

[constexpr noexcept default] QRecursiveMutex::QRecursiveMutex()

Crea un nuevo mutex recursivo. El mutex se crea en estado desbloqueado.

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

[noexcept] QRecursiveMutex::~QRecursiveMutex()

Destruye el mutex.

Advertencia: La destrucción de un mutex bloqueado puede provocar un comportamiento indefinido.

[noexcept(...)] void QRecursiveMutex::lock()

Bloquea el mutex. Si otro hilo ha bloqueado el mutex, esta llamada quedará bloqueada hasta que dicho hilo lo haya desbloqueado.

Se permite llamar a esta función varias veces sobre el mismo mutex desde el mismo hilo.

Nota: Esta función es «noexcept» cuando ` LockIsNoexcept ` es ` true`.

Véase también unlock().

[noexcept(...), since 6.6] bool QRecursiveMutex::tryLock(QDeadlineTimer timeout = {})

Intenta bloquear el mutex. Esta función devuelve ` true ` si se ha obtenido el bloqueo; en caso contrario, devuelve ` false`. Si otro hilo ha bloqueado el mutex, esta función esperará hasta que expire ` timeout ` para que el mutex quede disponible.

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

Se permite llamar a esta función varias veces sobre el mismo mutex desde el mismo hilo.

Esta función se introdujo en Qt 6.6.

Nota: Esta función es «noexcept» cuando LockIsNoexcept es true.

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

[noexcept(...)] bool QRecursiveMutex::tryLock(int timeout)

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

Nota: Pasar un número negativo como timeout equivale a llamar a lock(); es decir, esta función esperará indefinidamente hasta que se pueda bloquear el mutex si timeout es negativo.

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

Se permite llamar a esta función varias veces sobre el mismo mutex desde el mismo hilo.

Nota: Esta función es «noexcept» cuando ` LockIsNoexcept ` es ` true`.

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

[noexcept(...)] bool QRecursiveMutex::try_lock()

Intenta bloquear el mutex. Esta función devuelve ` true ` si se ha obtenido el bloqueo; en caso contrario, devuelve ` false`.

Esta función se proporciona para garantizar la compatibilidad con el concepto de la biblioteca estándar Lockable. Es equivalente a tryLock().

Nota: Esta función es «noexcept» cuando ` LockIsNoexcept ` es ` true`.

template <typename Rep, typename Period> bool QRecursiveMutex::try_lock_for(std::chrono::duration<Rep, Period> duration)

Intenta bloquear el mutex. Esta función devuelve ` true ` si se ha obtenido el bloqueo; en caso contrario, devuelve ` false`. Si otro hilo ha bloqueado el mutex, esta función esperará al menos ` duration ` a que el mutex quede disponible.

Nota: Pasar una duración negativa como duration equivale a llamar a try_lock(). Este comportamiento difiere del de tryLock().

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

Se permite llamar a esta función varias veces sobre el mismo mutex desde el mismo hilo.

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

template <typename Clock, typename Duration> bool QRecursiveMutex::try_lock_until(std::chrono::time_point<Clock, Duration> timePoint)

Intenta bloquear el mutex. Esta función devuelve ` true ` si se ha obtenido el bloqueo; en caso contrario, devuelve ` false`. Si otro hilo ha bloqueado el mutex, esta función esperará al menos hasta que ` timePoint ` para que el mutex quede disponible.

Nota: Pasar un ` timePoint ` que ya ha sido devuelto equivale a llamar a ` try_lock()`. Este comportamiento difiere del de ` tryLock()`.

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

Se permite llamar a esta función varias veces sobre el mismo mutex desde el mismo hilo.

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

[noexcept] void QRecursiveMutex::unlock()

Desbloquea el mutex. Si se intenta desbloquear un mutex en un hilo distinto al que lo bloqueó, se produce un error. Desbloquear un mutex que no está bloqueado da lugar a un comportamiento indefinido.

Véase también lock().

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