En esta página

QSemaphoreReleaser Class

La clase `QSemaphoreReleaser` permite aplazar de forma segura frente a excepciones una llamada a ` QSemaphore::release()`. Más información...

Encabezado: #include <QSemaphoreReleaser>
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 reentrantes.

Funciones públicas

QSemaphoreReleaser()
QSemaphoreReleaser(QSemaphore &sem, int n = 1)
QSemaphoreReleaser(QSemaphore *sem, int n = 1)
QSemaphoreReleaser(QSemaphoreReleaser &&other)
~QSemaphoreReleaser()
QSemaphore *cancel()
QSemaphore *semaphore() const
void swap(QSemaphoreReleaser &other)
QSemaphoreReleaser &operator=(QSemaphoreReleaser &&other)

Descripción detallada

QSemaphoreReleaser se puede utilizar en cualquier contexto en el que, de otro modo, se utilizaría QSemaphore::release(). La creación de un QSemaphoreReleaser aplaza la llamada a release() sobre el semáforo hasta que se destruya el QSemaphoreReleaser (véase el patrón RAII).

Se puede utilizar esto para liberar un semáforo de forma fiable y evitar así un interbloqueo ante excepciones o retornos anticipados:

// ... do something that may throw or return early
sem.release();

Si se produce una salida anticipada o se lanza una excepción antes de llegar a la llamada a ` sem.release() `, el semáforo no se libera, lo que podría impedir que el hilo que espera en la llamada correspondiente a ` sem.acquire() ` continúe nunca con la ejecución.

En cambio, al utilizar RAII:

const QSemaphoreReleaser releaser(sem);
// ... do something that may throw or early return
// implicitly calls sem.release() here and at every other return in between

esto ya no puede suceder, ya que el compilador se asegurará de que siempre se llame al destructor de `QSemaphoreReleaser` y, por lo tanto, el semáforo siempre se libere.

QSemaphoreReleaser admite la propiedad «move» y, por lo tanto, puede devolverse desde funciones para transferir la responsabilidad de liberar un semáforo fuera de una función o de un ámbito:

{ // some scope
    QSemaphoreReleaser releaser; // does nothing
    // ...
    if (someCondition) {
        releaser = QSemaphoreReleaser(sem);
        // ...
    }
    // ...
} // conditionally calls sem.release(), depending on someCondition

Un `QSemaphoreReleaser` puede cancelarse mediante una llamada a ` cancel()`. Un liberador de semáforos cancelado ya no llamará a ` QSemaphore::release()` en su destructor.

Véase también QMutexLocker.

Documentación de las funciones miembro

[constexpr noexcept default] QSemaphoreReleaser::QSemaphoreReleaser()

Constructor por defecto. Crea un QSemaphoreReleaser que no realiza ninguna acción.

[explicit noexcept] QSemaphoreReleaser::QSemaphoreReleaser(QSemaphore &sem, int n = 1)

Constructor. Almacena los argumentos y llama a ` sem.release(n)` en el destructor.

[explicit noexcept] QSemaphoreReleaser::QSemaphoreReleaser(QSemaphore *sem, int n = 1)

Constructor. Almacena los argumentos y llama a ` sem->release(n)` en el destructor.

[noexcept] QSemaphoreReleaser::QSemaphoreReleaser(QSemaphoreReleaser &&other)

Constructor de traslado. Asume la responsabilidad de llamar a ` QSemaphore::release()` desde ` other`, que a su vez se anula.

Véase también ` cancel()`.

[noexcept] QSemaphoreReleaser::~QSemaphoreReleaser()

A menos que se cancele, llama a ` QSemaphore::release()` con los argumentos proporcionados al constructor o por la última asignación de movimiento.

[noexcept] QSemaphore *QSemaphoreReleaser::cancel()

Anula este ` QSemaphoreReleaser ` de tal forma que el destructor ya no llamará a ` semaphore()->release()`. Devuelve el valor de ` semaphore()` antes de esta llamada. Tras esta llamada, ` semaphore()` devolverá ` nullptr`.

Para volver a activarlo, asigne un nuevo ` QSemaphoreReleaser`:

releaser.cancel(); // avoid releasing old semaphore()
releaser = QSemaphoreReleaser(sem, 42);
// now will call sem.release(42) when 'releaser' is destroyed

[noexcept] QSemaphore *QSemaphoreReleaser::semaphore() const

Devuelve un puntero al objeto ` QSemaphore ` proporcionado al constructor o mediante la última asignación de traslado, si la hubiera. En caso contrario, devuelve ` nullptr`.

[noexcept] void QSemaphoreReleaser::swap(QSemaphoreReleaser &other)

Intercambia las responsabilidades de *this y other.

A diferencia de la asignación por movimiento, ninguno de los dos objetos libera nunca su semáforo, si lo hay, como consecuencia del intercambio.

Por lo tanto, esta función es muy rápida y nunca falla.

[noexcept] QSemaphoreReleaser &QSemaphoreReleaser::operator=(QSemaphoreReleaser &&other)

Operador de asignación «move». Asume la responsabilidad de llamar a ` QSemaphore::release()` desde ` other`, que a su vez se cancela.

Si este liberador de semáforo tuviera la responsabilidad de llamar él mismo a algún ` QSemaphore::release()`, realiza la llamada antes de tomar el relevo de ` other`.

Véase también cancel().

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