signalslot.h

Go to the documentation of this file.

/*
 * LibrePCB - Professional EDA for everyone!
 * Copyright (C) 2013 LibrePCB Developers, see AUTHORS.md for contributors.
 * https://librepcb.org/
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef LIBREPCB_CORE_SIGNALSLOT_H
#define LIBREPCB_CORE_SIGNALSLOT_H

/*******************************************************************************
 *  Includes
 ******************************************************************************/
#include <QtCore>

#include <functional>

/*******************************************************************************
 *  Namespace / Forward Declarations
 ******************************************************************************/
namespace librepcb {

template <typename Tsender, typename... Args>
class Slot;

/*******************************************************************************
 *  Class Signal
 ******************************************************************************/

template <typename Tsender, typename... Args>
class Signal {
  friend class Slot<Tsender, Args...>;

public:
  // Constructors / Destructor
  Signal() = delete;
  Signal(const Signal& other) = delete;

  explicit Signal(const Tsender& sender) noexcept : mSender(sender) {}

  ~Signal() noexcept {
    for (auto slot : mSlots) {
      slot->mSignals.remove(this);
    }
  }

  int getSlotCount() const noexcept { return mSlots.count(); }

  void attach(Slot<Tsender, Args...>& slot) const noexcept {
    slot.mSignals.insert(this);
    mSlots.insert(&slot);
  }

  void detach(Slot<Tsender, Args...>& slot) const noexcept {
    slot.mSignals.remove(this);
    mSlots.remove(&slot);
  }

  void notify(Args... args) noexcept {
    // Note: A "foreach" loop with a Qt container first creates an implicitly
    // shared copy of the container (see
    // https://doc.qt.io/qt-5/containers.html#foreach). This is very important
    // since the callback might modify the container while iterating over it!
    // With std containers this would be much more complicated (or less
    // efficient).
    foreach (const auto& slot, mSlots) {
      // Check existence of the slot again because we must not call it if it
      // was detached (i.e. removed from the container) in the meantime.
      if (mSlots.contains(slot)) {
        slot->mCallback(mSender, args...);
      }
    }
  }

  // Operator Overloadings
  Signal& operator=(Signal const& other) = delete;

private:
  const Tsender& mSender;  
  mutable QSet<Slot<Tsender, Args...>*> mSlots;  
};

/*******************************************************************************
 *  Class Slot
 ******************************************************************************/

template <typename Tsender, typename... Args>
class Slot {
  friend class Signal<Tsender, Args...>;

public:
  // Constructors / Destructor
  Slot() = delete;
  Slot(const Slot& other) = delete;

  explicit Slot(
      const std::function<void(const Tsender&, Args...)>& callback) noexcept
    : mCallback(callback) {}

  template <typename T>
  explicit Slot(T& obj, void (T::*func)(const Tsender&, Args...)) noexcept
    : mCallback([=, &obj](const Tsender& s, Args... args) {
        (obj.*func)(s, args...);
      }) {}

  ~Slot() noexcept { detachAll(); }

  int getSignalCount() const noexcept { return mSignals.count(); }

  void detachAll() noexcept {
    for (auto signal : mSignals) {
      signal->mSlots.remove(this);
    }
    mSignals.clear();
  }

  // Operator Overloadings
  Slot& operator=(Slot const& other) = delete;

private:
  QSet<const Signal<Tsender, Args...>*> mSignals;

  std::function<void(const Tsender&, Args...)> mCallback;
};

/*******************************************************************************
 *  End of File
 ******************************************************************************/

}  // namespace librepcb

#endif