https://github.com/misje/once
Connect a Qt slot/functor/signal and disconnect it immediately after execution.
https://github.com/misje/once
connect disconnect once qt single-shot
Last synced: about 2 months ago
JSON representation
Connect a Qt slot/functor/signal and disconnect it immediately after execution.
- Host: GitHub
- URL: https://github.com/misje/once
- Owner: misje
- License: mit
- Created: 2018-08-26T18:56:56.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-08-10T14:03:29.000Z (almost 5 years ago)
- Last Synced: 2025-04-12T05:53:51.722Z (about 2 months ago)
- Topics: connect, disconnect, once, qt, single-shot
- Language: C++
- Homepage:
- Size: 14.6 KB
- Stars: 25
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# once
Sometimes you want to connect a slot or a functor to a Qt signal and only have it be called once. Adding the necessary logic to enable this can mess up the code unnecessarily, especially with lambdas, since a connection handle is needed to disconnect them.
This tiny framework provides connect functions argument-compatible with the QObject::connect series that will call the slot or functor only once. The logic is simple:
- Create a pointer that will store the connection handle returned from QObject::connect
- Capture this pointer in a wrapper function
- Connect the passed signal to call the wrapper function
- Disconnect the connection inside the wrapper function and then call the passed functor or slot
Although the fire-once-only logic is simple, additional logic and template code is needed since Once::connect needs to work like QObject::connect: accept all kinds of functors, lambda and slots and conveniently discard superfluous signal arguments. The implementation allows perfect forwarding of arguments and, although it can probably be simplified, should work just as QObject::connect does.
## Methods
The following methods are available. Note that the function signature is simplified for readability. Remember that a slot also can be a signal.
```cpp
/* Call functor when signal is emitted from sender and disconnect it
immediately afterwards */
QMetaObject::Connection Once::connect(const QObject *sender, Signal signal,
Functor functor)
/* Call functor when signal is emitted from sender in the given context, using
the given connection type. Disconnect functor immediately afterwards. */
QMetaObject::Connection Once::connect(const QObject *sender, Signal signal,
const QObject *context, Functor functor, Qt::ConnectionType type =
Qt::AutoConnection)
/* Call functor when signal is emitted from sender and disconnect it after N
calls, specified by callCount. */
QMetaObject::Connection Once::connect(const QObject *sender, Signal signal, int
callCount, Functor functor)
/* Call functor when signal is emitted from sender in the given context, using
the given connection type. Disconnect functor after N calls, specified by
callCount. */
QMetaObject::Connection Once::connect(const QObject *sender, Signal signal, int
callCount, const QObject *context, Functor functor, Qt::ConnectionType
type = Qt::AutoConnection)
/* Call member function when signal is emitted from sender (in the context of
receiver), using the given connection type. Disconnect the slot immediately
afterwards. */
QMetaObject::Connection Once::connect(const QObject *sender, Signal signal,
const QObject *receiver, Slot slot, Qt::ConnectionType type =
Qt::AutoConnection)
/* Call member function when signal is emitted from sender (in the context of
receiver), using the given connection type. Disconnect the slot after N
calls, specified by callCount. */
QMetaObject::Connection Once::connect(const QObject *sender, Signal signal, int
callCount, const QObject *receiver, Slot slot, Qt::ConnectionType type =
Qt::AutoConnection)
```
## How to use
Include once.h in your project and use a compiler that supports C++11 (or
higher). Use `Once::connect` as you would use `QObject::connect`. If you need
to disconnect the slot/functor/signal, disconnect the returned
`QMetaObject::Connection` with `static bool QObject::disconnect(const
QMetaObject::Connection &connection)`.