402 lines
14 KiB
C++
402 lines
14 KiB
C++
// Boost.Signals library
|
|
|
|
// Copyright Douglas Gregor 2001-2004. Use, modification and
|
|
// distribution is subject to the Boost Software License, Version
|
|
// 1.0. (See accompanying file LICENSE_1_0.txt or copy at
|
|
// http://www.boost.org/LICENSE_1_0.txt)
|
|
|
|
// For more information, see http://www.boost.org
|
|
|
|
// This file intentionally does not have include guards, because it is meant
|
|
// to be included multiple times (one for each signalN class). The
|
|
// BOOST_SIGNALS_SIGNAL_TEMPLATE_HEADER_INCLUDED macro merely serves to
|
|
// suppress reinclusion of the files that this header depends on.
|
|
|
|
#ifndef BOOST_SIGNALS_SIGNAL_TEMPLATE_HEADER_INCLUDED
|
|
#define BOOST_SIGNALS_SIGNAL_TEMPLATE_HEADER_INCLUDED
|
|
# include <boost/config.hpp>
|
|
# include <boost/signals/connection.hpp>
|
|
# include <boost/ref.hpp>
|
|
# include <boost/signals/slot.hpp>
|
|
# include <boost/last_value.hpp>
|
|
# include <boost/signals/detail/signal_base.hpp>
|
|
# include <boost/signals/detail/slot_call_iterator.hpp>
|
|
# include <boost/mpl/bool.hpp>
|
|
# include <boost/type_traits/is_convertible.hpp>
|
|
# include <cassert>
|
|
# include <functional>
|
|
# include <memory>
|
|
#endif // !BOOST_SIGNALS_SIGNAL_TEMPLATE_HEADER_INCLUDED
|
|
|
|
#ifdef BOOST_HAS_ABI_HEADERS
|
|
# include BOOST_ABI_PREFIX
|
|
#endif
|
|
|
|
// Include the appropriate functionN header
|
|
#define BOOST_SIGNAL_FUNCTION_N_HEADER BOOST_JOIN(<boost/function/function,BOOST_SIGNALS_NUM_ARGS.hpp>)
|
|
#include BOOST_SIGNAL_FUNCTION_N_HEADER
|
|
|
|
// Determine if a comma should follow a listing of the arguments/parameters
|
|
#if BOOST_SIGNALS_NUM_ARGS == 0
|
|
# define BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
#else
|
|
# define BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS ,
|
|
#endif // BOOST_SIGNALS_NUM_ARGS > 0
|
|
|
|
// Define class names used
|
|
#define BOOST_SIGNALS_SIGNAL BOOST_JOIN(signal,BOOST_SIGNALS_NUM_ARGS)
|
|
#define BOOST_SIGNALS_FUNCTION BOOST_JOIN(function,BOOST_SIGNALS_NUM_ARGS)
|
|
#define BOOST_SIGNALS_ARGS_STRUCT BOOST_JOIN(args,BOOST_SIGNALS_NUM_ARGS)
|
|
#define BOOST_SIGNALS_CALL_BOUND BOOST_JOIN(call_bound,BOOST_SIGNALS_NUM_ARGS)
|
|
|
|
// Define commonly-used instantiations
|
|
#define BOOST_SIGNALS_ARGS_STRUCT_INST \
|
|
BOOST_SIGNALS_NAMESPACE::detail::BOOST_SIGNALS_ARGS_STRUCT<BOOST_SIGNALS_TEMPLATE_ARGS>
|
|
|
|
namespace boost {
|
|
namespace BOOST_SIGNALS_NAMESPACE {
|
|
namespace detail {
|
|
// Holds the arguments for a bound slot call in a single place
|
|
template<BOOST_SIGNALS_TEMPLATE_PARMS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
typename Dummy = int>
|
|
struct BOOST_SIGNALS_ARGS_STRUCT {
|
|
BOOST_SIGNALS_ARGS_STRUCT(BOOST_SIGNALS_COPY_PARMS)
|
|
BOOST_SIGNALS_INIT_ARGS
|
|
{
|
|
}
|
|
|
|
BOOST_SIGNALS_ARGS_AS_MEMBERS
|
|
};
|
|
|
|
// Function object that calls the function object given to it, passing
|
|
// the bound arguments along to that underlying function object
|
|
template<typename R>
|
|
struct BOOST_SIGNALS_CALL_BOUND {
|
|
template<BOOST_SIGNALS_TEMPLATE_PARMS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
typename F>
|
|
struct caller {
|
|
typedef BOOST_SIGNALS_ARGS_STRUCT<BOOST_SIGNALS_TEMPLATE_ARGS>*
|
|
args_type;
|
|
|
|
args_type args;
|
|
|
|
typedef R result_type;
|
|
|
|
caller() {}
|
|
caller(args_type a) : args(a) {}
|
|
|
|
template<typename Pair>
|
|
R operator()(const Pair& slot) const
|
|
{
|
|
F* target = const_cast<F*>(unsafe_any_cast<F>(&slot.second));
|
|
return (*target)(BOOST_SIGNALS_BOUND_ARGS);
|
|
}
|
|
};
|
|
};
|
|
|
|
template<>
|
|
struct BOOST_SIGNALS_CALL_BOUND<void> {
|
|
template<BOOST_SIGNALS_TEMPLATE_PARMS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
typename F>
|
|
struct caller {
|
|
typedef BOOST_SIGNALS_ARGS_STRUCT<BOOST_SIGNALS_TEMPLATE_ARGS>*
|
|
args_type;
|
|
|
|
args_type args;
|
|
|
|
typedef unusable result_type;
|
|
|
|
caller(args_type a) : args(a) {}
|
|
|
|
template<typename Pair>
|
|
unusable operator()(const Pair& slot) const
|
|
{
|
|
F* target = const_cast<F*>(unsafe_any_cast<F>(&slot.second));
|
|
(*target)(BOOST_SIGNALS_BOUND_ARGS);
|
|
return unusable();
|
|
}
|
|
};
|
|
};
|
|
} // namespace detail
|
|
} // namespace BOOST_SIGNALS_NAMESPACE
|
|
|
|
// The actual signalN class
|
|
template<
|
|
typename R,
|
|
BOOST_SIGNALS_TEMPLATE_PARMS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
typename Combiner = last_value<R>,
|
|
typename Group = int,
|
|
typename GroupCompare = std::less<Group>,
|
|
typename SlotFunction = BOOST_SIGNALS_FUNCTION<
|
|
R BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
BOOST_SIGNALS_TEMPLATE_ARGS>
|
|
>
|
|
class BOOST_SIGNALS_SIGNAL :
|
|
public BOOST_SIGNALS_NAMESPACE::detail::signal_base, // management of slot list
|
|
public BOOST_SIGNALS_NAMESPACE::trackable // signals are trackable
|
|
{
|
|
public:
|
|
// The slot function type
|
|
typedef SlotFunction slot_function_type;
|
|
|
|
// Result type of a slot
|
|
typedef typename BOOST_SIGNALS_NAMESPACE::detail::slot_result_type<R>::type
|
|
slot_result_type;
|
|
|
|
// Argument types
|
|
BOOST_SIGNALS_ARG_TYPES
|
|
|
|
#if BOOST_SIGNALS_NUM_ARGS == 1
|
|
typedef T1 argument_type;
|
|
#elif BOOST_SIGNALS_NUM_ARGS == 2
|
|
typedef T1 first_argument_type;
|
|
typedef T2 second_argument_type;
|
|
#endif
|
|
|
|
private:
|
|
// The real slot name comparison object type
|
|
typedef BOOST_SIGNALS_NAMESPACE::detail::group_bridge_compare<GroupCompare, Group>
|
|
real_group_compare_type;
|
|
|
|
// The function object passed to the slot call iterator that will call
|
|
// the underlying slot function with its arguments bound
|
|
typedef BOOST_SIGNALS_NAMESPACE::detail::BOOST_SIGNALS_CALL_BOUND<R>
|
|
outer_bound_slot_caller;
|
|
typedef typename outer_bound_slot_caller::template
|
|
caller<BOOST_SIGNALS_TEMPLATE_ARGS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
slot_function_type>
|
|
call_bound_slot;
|
|
|
|
public:
|
|
// Combiner's result type
|
|
typedef typename Combiner::result_type result_type;
|
|
|
|
// Combiner type
|
|
typedef Combiner combiner_type;
|
|
|
|
// Slot type
|
|
typedef slot<slot_function_type> slot_type;
|
|
|
|
// Slot name type and comparison
|
|
typedef Group group_type;
|
|
typedef GroupCompare group_compare_type;
|
|
|
|
typedef BOOST_SIGNALS_NAMESPACE::detail::slot_call_iterator<
|
|
call_bound_slot, iterator> slot_call_iterator;
|
|
|
|
explicit
|
|
BOOST_SIGNALS_SIGNAL(const Combiner& c = Combiner(),
|
|
const GroupCompare& comp = GroupCompare()) :
|
|
BOOST_SIGNALS_NAMESPACE::detail::signal_base(real_group_compare_type(comp),
|
|
c)
|
|
{
|
|
}
|
|
|
|
// Connect a slot to this signal
|
|
BOOST_SIGNALS_NAMESPACE::connection
|
|
connect(const slot_type&,
|
|
BOOST_SIGNALS_NAMESPACE::connect_position at
|
|
= BOOST_SIGNALS_NAMESPACE::at_back);
|
|
|
|
|
|
BOOST_SIGNALS_NAMESPACE::connection
|
|
connect(const group_type&, const slot_type&,
|
|
BOOST_SIGNALS_NAMESPACE::connect_position at
|
|
= BOOST_SIGNALS_NAMESPACE::at_back);
|
|
|
|
template<typename T>
|
|
void disconnect(const T& t)
|
|
{
|
|
typedef mpl::bool_<(is_convertible<T, group_type>::value)> is_group;
|
|
this->do_disconnect(t, is_group());
|
|
}
|
|
|
|
private:
|
|
// Disconnect a named slot
|
|
void do_disconnect(const group_type& group, mpl::bool_<true>)
|
|
{
|
|
impl->disconnect(group);
|
|
}
|
|
|
|
template<typename Function>
|
|
void do_disconnect(const Function& f, mpl::bool_<false>)
|
|
{
|
|
// Notify the slot handling code that we are iterating through the slots
|
|
BOOST_SIGNALS_NAMESPACE::detail::call_notification notification(this->impl);
|
|
|
|
for (iterator i = impl->slots_.begin(); i != impl->slots_.end(); ++i) {
|
|
slot_function_type& s = *unsafe_any_cast<slot_function_type>(&i->second);
|
|
if (s == f) i->first.disconnect();
|
|
}
|
|
}
|
|
|
|
public:
|
|
|
|
// Emit the signal
|
|
result_type operator()(BOOST_SIGNALS_PARMS);
|
|
result_type operator()(BOOST_SIGNALS_PARMS) const;
|
|
|
|
Combiner& combiner()
|
|
{ return *unsafe_any_cast<Combiner>(&impl->combiner_); }
|
|
|
|
const Combiner& combiner() const
|
|
{ return *unsafe_any_cast<const Combiner>(&impl->combiner_); }
|
|
};
|
|
|
|
template<
|
|
typename R,
|
|
BOOST_SIGNALS_TEMPLATE_PARMS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
typename Combiner,
|
|
typename Group,
|
|
typename GroupCompare,
|
|
typename SlotFunction
|
|
>
|
|
BOOST_SIGNALS_NAMESPACE::connection
|
|
BOOST_SIGNALS_SIGNAL<
|
|
R, BOOST_SIGNALS_TEMPLATE_ARGS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
Combiner, Group, GroupCompare, SlotFunction
|
|
>::connect(const slot_type& in_slot,
|
|
BOOST_SIGNALS_NAMESPACE::connect_position at)
|
|
{
|
|
using boost::BOOST_SIGNALS_NAMESPACE::detail::stored_group;
|
|
|
|
// If the slot has been disconnected, just return a disconnected
|
|
// connection
|
|
if (!in_slot.is_active()) {
|
|
return BOOST_SIGNALS_NAMESPACE::connection();
|
|
}
|
|
|
|
return impl->connect_slot(in_slot.get_slot_function(), stored_group(),
|
|
in_slot.get_data(), at);
|
|
}
|
|
|
|
template<
|
|
typename R,
|
|
BOOST_SIGNALS_TEMPLATE_PARMS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
typename Combiner,
|
|
typename Group,
|
|
typename GroupCompare,
|
|
typename SlotFunction
|
|
>
|
|
BOOST_SIGNALS_NAMESPACE::connection
|
|
BOOST_SIGNALS_SIGNAL<
|
|
R, BOOST_SIGNALS_TEMPLATE_ARGS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
Combiner, Group, GroupCompare, SlotFunction
|
|
>::connect(const group_type& group,
|
|
const slot_type& in_slot,
|
|
BOOST_SIGNALS_NAMESPACE::connect_position at)
|
|
{
|
|
// If the slot has been disconnected, just return a disconnected
|
|
// connection
|
|
if (!in_slot.is_active()) {
|
|
return BOOST_SIGNALS_NAMESPACE::connection();
|
|
}
|
|
|
|
return impl->connect_slot(in_slot.get_slot_function(), group,
|
|
in_slot.get_data(), at);
|
|
}
|
|
|
|
template<
|
|
typename R,
|
|
BOOST_SIGNALS_TEMPLATE_PARMS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
typename Combiner,
|
|
typename Group,
|
|
typename GroupCompare,
|
|
typename SlotFunction
|
|
>
|
|
typename BOOST_SIGNALS_SIGNAL<
|
|
R, BOOST_SIGNALS_TEMPLATE_ARGS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
Combiner, Group, GroupCompare, SlotFunction>::result_type
|
|
BOOST_SIGNALS_SIGNAL<
|
|
R, BOOST_SIGNALS_TEMPLATE_ARGS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
Combiner, Group, GroupCompare, SlotFunction
|
|
>::operator()(BOOST_SIGNALS_PARMS)
|
|
{
|
|
// Notify the slot handling code that we are making a call
|
|
BOOST_SIGNALS_NAMESPACE::detail::call_notification notification(this->impl);
|
|
|
|
// Construct a function object that will call the underlying slots
|
|
// with the given arguments.
|
|
#if BOOST_SIGNALS_NUM_ARGS == 0
|
|
BOOST_SIGNALS_ARGS_STRUCT_INST args;
|
|
#else
|
|
BOOST_SIGNALS_ARGS_STRUCT_INST args(BOOST_SIGNALS_ARGS);
|
|
#endif // BOOST_SIGNALS_NUM_ARGS > 0
|
|
call_bound_slot f(&args);
|
|
|
|
typedef typename call_bound_slot::result_type call_result_type;
|
|
optional<call_result_type> cache;
|
|
// Let the combiner call the slots via a pair of input iterators
|
|
return combiner()(slot_call_iterator(notification.impl->slots_.begin(),
|
|
impl->slots_.end(), f, cache),
|
|
slot_call_iterator(notification.impl->slots_.end(),
|
|
impl->slots_.end(), f, cache));
|
|
}
|
|
|
|
template<
|
|
typename R,
|
|
BOOST_SIGNALS_TEMPLATE_PARMS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
typename Combiner,
|
|
typename Group,
|
|
typename GroupCompare,
|
|
typename SlotFunction
|
|
>
|
|
typename BOOST_SIGNALS_SIGNAL<
|
|
R, BOOST_SIGNALS_TEMPLATE_ARGS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
Combiner, Group, GroupCompare, SlotFunction>::result_type
|
|
BOOST_SIGNALS_SIGNAL<
|
|
R, BOOST_SIGNALS_TEMPLATE_ARGS
|
|
BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
Combiner, Group, GroupCompare, SlotFunction
|
|
>::operator()(BOOST_SIGNALS_PARMS) const
|
|
{
|
|
// Notify the slot handling code that we are making a call
|
|
BOOST_SIGNALS_NAMESPACE::detail::call_notification notification(this->impl);
|
|
|
|
// Construct a function object that will call the underlying slots
|
|
// with the given arguments.
|
|
#if BOOST_SIGNALS_NUM_ARGS == 0
|
|
BOOST_SIGNALS_ARGS_STRUCT_INST args;
|
|
#else
|
|
BOOST_SIGNALS_ARGS_STRUCT_INST args(BOOST_SIGNALS_ARGS);
|
|
#endif // BOOST_SIGNALS_NUM_ARGS > 0
|
|
|
|
call_bound_slot f(&args);
|
|
|
|
typedef typename call_bound_slot::result_type call_result_type;
|
|
optional<call_result_type> cache;
|
|
|
|
// Let the combiner call the slots via a pair of input iterators
|
|
return combiner()(slot_call_iterator(notification.impl->slots_.begin(),
|
|
impl->slots_.end(), f, cache),
|
|
slot_call_iterator(notification.impl->slots_.end(),
|
|
impl->slots_.end(), f, cache));
|
|
}
|
|
} // namespace boost
|
|
|
|
#undef BOOST_SIGNAL_FUNCTION_N_HEADER
|
|
#undef BOOST_SIGNALS_ARGS_STRUCT_INST
|
|
#undef BOOST_SIGNALS_CALL_BOUND
|
|
#undef BOOST_SIGNALS_ARGS_STRUCT
|
|
#undef BOOST_SIGNALS_FUNCTION
|
|
#undef BOOST_SIGNALS_SIGNAL
|
|
#undef BOOST_SIGNALS_COMMA_IF_NONZERO_ARGS
|
|
|
|
#ifdef BOOST_HAS_ABI_HEADERS
|
|
# include BOOST_ABI_SUFFIX
|
|
#endif
|