/***********************************************************************
* fcallback.h - Implements the callback functionality *
* *
* This file is part of the FINAL CUT widget toolkit *
* *
* Copyright 2020 Markus Gans *
* *
* FINAL CUT is free software; you can redistribute it and/or modify *
* it under the terms of the GNU Lesser General Public License as *
* published by the Free Software Foundation; either version 3 of *
* the License, or (at your option) any later version. *
* *
* FINAL CUT 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 Lesser General Public License for more details. *
* *
* You should have received a copy of the GNU Lesser General Public *
* License along with this program. If not, see *
* . *
***********************************************************************/
/* Standalone class
* ════════════════
*
* ▕▔▔▔▔▔▔▔▔▔▔▔▏1 *▕▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▏
* ▕ FCallback ▏- - - -▕ FCallbackData ▏
* ▕▁▁▁▁▁▁▁▁▁▁▁▏ ▕▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▏
*/
#ifndef FCALLBACK_H
#define FCALLBACK_H
#if !defined (USE_FINAL_H) && !defined (COMPILE_FINAL_CUT)
#error "Only can be included directly."
#endif
#include
#include
#include "final/fstring.h"
#include "final/ftypes.h"
namespace finalcut
{
// class forward declaration
class FWidget;
//----------------------------------------------------------------------
// struct FCallbackData
//----------------------------------------------------------------------
struct FCallbackData
{
// Constructor
FCallbackData()
{ }
template
FCallbackData (const FString& s, FWidget* i, FuncPtr m, const FCall& c)
: cb_signal(s)
, cb_instance(i)
, cb_function_ptr(m)
, cb_function(c)
{ }
FCallbackData (const FCallbackData&) = default;
FCallbackData (FCallbackData&&) = default;
FCallbackData& operator = (const FCallbackData&) = default;
FCallbackData& operator = (FCallbackData&&) noexcept = default;
// Data members
FString cb_signal{};
FWidget* cb_instance{};
void* cb_function_ptr{};
FCall cb_function{};
};
//----------------------------------------------------------------------
// class FCallback
//----------------------------------------------------------------------
class FCallback
{
public:
// Using-declaration
template
using ObjectPointer =
typename std::enable_if< ! std::is_member_function_pointer::value
&& ! std::is_function::type>::value
&& ! std::is_function::value
&& std::is_pointer::value
&& std::is_object::value
&& ! std::is_class::value
, std::nullptr_t >;
template
using ClassObject =
typename std::enable_if< ! std::is_member_function_pointer::value
&& ! std::is_function::type>::value
&& ! std::is_function::value
&& ! std::is_pointer::value
&& std::is_object::value
&& std::is_class::value
, std::nullptr_t >;
template
using MemberFunctionPointer =
typename std::enable_if< std::is_member_function_pointer::value
&& ! std::is_function::type>::value
&& ! std::is_function::value
&& ! std::is_pointer::value
&& std::is_object::value
&& ! std::is_class::value
, std::nullptr_t >;
template
using FunctionPointer =
typename std::enable_if< ! std::is_member_function_pointer::value
&& std::is_function::type>::value
&& ! std::is_function::value
&& std::is_pointer::value
&& std::is_object::value
&& ! std::is_class::value
, std::nullptr_t >;
template
using FunctionReference =
typename std::enable_if< ! std::is_member_function_pointer::value
&& std::is_function::type>::value
&& std::is_function::value
&& ! std::is_pointer::value
&& ! std::is_object::value
&& ! std::is_class::value
, std::nullptr_t >;
// Constructors
FCallback() = default;
// Disable copy constructor
FCallback (const FCallback&) = delete;
// Destructor
~FCallback() noexcept = default;
// Disable copy assignment operator (=)
FCallback& operator = (const FCallback&) = delete;
// Accessors
FString getClassName() const;
std::size_t getCallbackCount() const;
// Methods
template ::type = nullptr
, typename MemberFunctionPointer::type = nullptr
, typename... Args>
void addCallback ( const FString& cb_signal
, Object&& cb_instance
, Function&& cb_member
, Args&&... args) noexcept;
template ::type = nullptr
, typename ClassObject::type = nullptr
, typename... Args>
void addCallback ( const FString& cb_signal
, Object&& cb_instance
, Function&& cb_function
, Args&&... args) noexcept;
template < typename Function
, typename ClassObject::type = nullptr
, typename... Args>
void addCallback ( const FString& cb_signal
, Function&& cb_function
, Args&&... args) noexcept;
template ::type = nullptr
, typename... Args>
void addCallback ( const FString& cb_signal
, Function& cb_function
, Args&&... args) noexcept;
template ::type = nullptr
, typename... Args>
void addCallback ( const FString& cb_signal
, Function& cb_function
, Args&&... args) noexcept;
template ::type = nullptr
, typename... Args>
void addCallback ( const FString& cb_signal
, Function&& cb_function
, Args&&... args) noexcept;
template ::type = nullptr>
void delCallback (Object&& cb_instance) noexcept;
void delCallback (const FString& cb_signal);
template ::type = nullptr>
void delCallback ( const FString& cb_signal
, Object&& cb_instance ) noexcept;
template ::type = nullptr>
void delCallback (FunctionPtr&& cb_func_ptr) noexcept;
template ::type = nullptr>
void delCallback (const Function& cb_function);
void delCallback();
void emitCallback (const FString& emit_signal) const;
private:
// Using-declaration
using FCallbackObjects = std::vector;
// Data members
FCallbackObjects callback_objects{};
};
// FCallback inline functions
//----------------------------------------------------------------------
inline FString FCallback::getClassName() const
{ return "FCallback"; }
//----------------------------------------------------------------------
inline std::size_t FCallback::getCallbackCount() const
{ return callback_objects.size(); }
//----------------------------------------------------------------------
template ::type
, typename FCallback::MemberFunctionPointer::type
, typename... Args>
inline void FCallback::addCallback ( const FString& cb_signal
, Object&& cb_instance
, Function&& cb_member
, Args&&... args) noexcept
{
// Add a member function pointer as callback
Object instance = cb_instance;
auto fn = std::bind ( std::forward(cb_member)
, std::forward