乐趣区

关于qt:写一个只触发一次槽函数的Qt-connect函数

jiezi

在之前的 Qt 我的项目中，我发现常常会用到槽函数只须要执行一次的状况。也就是说，槽函数执行一次后，就须要 disconnect 对应的连贯。然而，真正操作起来实际上挺麻烦的，或者说不优雅。因为你须要把之前 connect 时产生的 QMetaObject::Connection 对象保存起来，而保留它不能用局部变量，通常须要保留到类的成员变量中，或者其余生命周期足够长的中央，以避免在 disconnect 它的时候，它曾经生效了。总之，须要使用者本人保护，因此减少了使用者的累赘。

如果有一个办法可能在槽函数执行实现后主动 disconnect 掉连贯就好了。我在网上找了一段时间，却没有找到适合的解决方案，相干探讨也比拟少，可能这不是一个很常见的需要吧。不过还是在 GitHub 上找到了一个相干的库：https://github.com/misje/once，然而看它的源码，感觉比较复杂。它针对 QObject::connect 函数的每种状况，写了对应的实现，总感觉太简单了，应该存在一种更通用的办法。

最近在浏览了《C++ Primer》模板相干的章节后，我忽然想到兴许用完满转发相干的货色能够简化实现。于是试着写了一下，貌似真得能够，代码如下：

ConnectionUtil.h：

#pragma once

#include <QObject>
#include <QMap>

namespace ConnectionUtil
{
    typedef QMetaObject::Connection Conn;

    struct ConnKey {};

    extern QMap<ConnKey*, QPair<Conn, Conn>> connMap;

    class ReceiverObj : public QObject
    {
        Q_OBJECT

    public:
        explicit ReceiverObj(ConnKey *connKey) : key(connKey) {}

    public slots:
        void slot();

    private:
        ConnKey *key;
    };

    // 解决信号为 SIGNAL(...)的状况
    template <typename Sender, typename ...Args>
    void connect(Sender &&sender, const char *signal, Args &&...args)
    {
        ConnKey *connKey = new ConnKey;
        Conn conn1 = QObject::connect(std::forward<Sender>(sender), signal, std::forward<Args>(args)...);
        Conn conn2 = QObject::connect(std::forward<Sender>(sender), signal, new ReceiverObj(connKey), SLOT(slot()));
        connMap.insert(connKey, qMakePair(std::move(conn1), std::move(conn2)));
    }

    // 解决其余状况
    template <typename Sender, typename Signal, typename ...Args>
    void connect(Sender &&sender, Signal &&signal, Args &&...args)
    {
        ConnKey *connKey = new ConnKey;
        Conn conn1 = QObject::connect(std::forward<Sender>(sender), std::forward<Signal>(signal), std::forward<Args>(args)...);
        Conn conn2 = QObject::connect(std::forward<Sender>(sender), std::forward<Signal>(signal), [connKey] {ReceiverObj(connKey).slot();});
        connMap.insert(connKey, qMakePair(std::move(conn1), std::move(conn2)));
    }
}

ConnectionUtil.cpp：

#include "ConnectionUtil.h"

using namespace ConnectionUtil;

QMap<ConnKey *, QPair<Conn, Conn>> ConnectionUtil::connMap;

void ReceiverObj::slot()
{const QPair<Conn, Conn> &connections = connMap.value(key);
    QObject::disconnect(connections.first);
    QObject::disconnect(connections.second);
    connMap.remove(key);
    delete key;
    deleteLater();}

这个实现假设 QObject::connect 的所有重载函数前两个参数别离是 Sender 和 Signal，事实上的确是这样。关键点就是，额定建设一个连贯，在收到信号后，disconnect 用户的连贯。不过，我总感觉这个实现在多线程的状况下可能有 bug，但在通过简略的测试后，临时没有发现。应用示例如下：

ConnectionUtil::connect(this, SIGNAL(bong(int)), obj, SLOT(slotBong(int)), Qt::QueuedConnection);

ConnectionUtil::connect(this, &MainWindow::bong, obj, &SomeObject::slotBong, Qt::QueuedConnection);

ConnectionUtil::connect(this, &MainWindow::bong, this, []() {qDebug() << "bingo";
});

请大家批评指正。

退出移动版