| Index: base/bind_internal.h.pump
|
| diff --git a/base/bind_internal.h.pump b/base/bind_internal.h.pump
|
| index 429e13f4e57d0016a1d5212c4f3de00116802cc9..1192974455f4c63b68bc499fb34c8cf13177403e 100644
|
| --- a/base/bind_internal.h.pump
|
| +++ b/base/bind_internal.h.pump
|
| @@ -5,7 +5,14 @@ $$
|
| $$ http://code.google.com/p/googletest/wiki/PumpManual
|
| $$
|
|
|
| +// TODO(ajwong): If you create an fully unbound method, is there a way to
|
| +// enforce the first argument must be refcounted? Or do we just say
|
| +// "oh well"?
|
| +//
|
| +// Do we want to allow creating a fully unbound method??
|
| +
|
| $var MAX_ARITY = 6
|
| +$range ARITY 0..MAX_ARITY
|
|
|
| // Copyright (c) 2011 The Chromium Authors. All rights reserved.
|
| // Use of this source code is governed by a BSD-style license that can be
|
| @@ -29,371 +36,463 @@ $var MAX_ARITY = 6
|
| namespace base {
|
| namespace internal {
|
|
|
| -// The method by which a function is invoked is determined by 3 different
|
| -// dimensions:
|
| +// CONCEPTS:
|
| +// Runnable -- A type (really a type class) that has a single Run() method
|
| +// and a RunType typedef that corresponds to the type of Run().
|
| +// A Runnable can declare that it should treated like a method
|
| +// call by including a typedef named IsMethod. The value of
|
| +// this typedef is NOT inspected, only the existence. When a
|
| +// Runnable declares itself a method, Bind() will enforce special
|
| +// refcounting + WeakPtr handling semantics for the first
|
| +// parameter which is expected to be an object.
|
| +// Functor -- A copyable type representing something that should be called.
|
| +// All function pointers, Callback<>, and Runnables are functors
|
| +// even if the invocation syntax differs.
|
| +// RunType -- A function type (as opposed to function _pointer_ type) for
|
| +// a Run() function. Usually just a convenience typedef.
|
| +// (Bound)ArgsType -- A function type that is being (ab)used to store the
|
| +// types of set of arguments. The "return" type is always
|
| +// void here. We use this hack so that we do not need
|
| +// a new type name for each arity of type. (eg.,
|
| +// BindState1, BindState2). This makes forward
|
| +// declarations and friending much much easier.
|
| //
|
| -// 1) The type of function (normal or method).
|
| -// 2) The arity of the function.
|
| -// 3) The number of bound parameters.
|
| +// Types:
|
| +// RunnableAdapter<> -- Wraps the various "function" pointer types into an
|
| +// object that adheres to the Runnable interface.
|
| +// There are |3*ARITY| RunnableAdapter types.
|
| +// FunctionTraits<> -- Type traits that unwrap a function signature into a
|
| +// a set of easier to use typedefs. Used mainly for
|
| +// compile time asserts.
|
| +// There are |ARITY| FunctionTraits types.
|
| +// ForceVoidReturn<> -- Helper class for translating function signatures to
|
| +// equivalent forms with a "void" return type.
|
| +// There are |ARITY| ForceVoidReturn types.
|
| +// FunctorTraits<> -- Type traits used determine the correct RunType and
|
| +// RunnableType for a Functor. This is where function
|
| +// signature adapters are applied.
|
| +// There are |ARITY| ForceVoidReturn types.
|
| +// MakeRunnable<> -- Takes a Functor and returns an object in the Runnable
|
| +// type class that represents the underlying Functor.
|
| +// There are |O(1)| MakeRunnable types.
|
| +// InvokeHelper<> -- Take a Runnable + arguments and actully invokes it.
|
| +// Handle the differing syntaxes needed for WeakPtr<> support,
|
| +// and for ignoring return values. This is separate from
|
| +// Invoker to avoid creating multiple version of Invoker<>
|
| +// which grows at O(n^2) with the arity.
|
| +// There are |k*ARITY| InvokeHelper types.
|
| +// Invoker<> -- Unwraps the curried parameters and executes the Runnable.
|
| +// There are |(ARITY^2 + ARITY)/2| Invoketypes.
|
| +// BindState<> -- Stores the curried parameters, and is the main entry point
|
| +// into the Bind() system, doing most of the type resolution.
|
| +// There are ARITY BindState types.
|
| +
|
| +
|
| +// RunnableAdapter<>
|
| //
|
| -// The templates below handle the determination of each of these dimensions.
|
| -// In brief:
|
| -//
|
| -// FunctionTraits<> -- Provides a normalied signature, and other traits.
|
| -// InvokerN<> -- Provides a DoInvoke() function that actually executes
|
| -// a calback.
|
| -// InvokerStorageN<> -- Provides storage for the bound parameters, and
|
| -// typedefs to the above.
|
| -// IsWeakMethod<> -- Determines if we are binding a method to a WeakPtr<>.
|
| -//
|
| -// More details about the design of each class is included in a comment closer
|
| -// to their defition.
|
| -
|
| -
|
| -// IsWeakMethod determines if we are binding a method to a WeakPtr<> for an
|
| -// object. It is used to select an InvokerN that will no-op itself in the
|
| -// event the WeakPtr<> for the target object is invalidated.
|
| -template <bool IsMethod, typename T>
|
| -struct IsWeakMethod : public false_type {};
|
| -
|
| -template <typename T>
|
| -struct IsWeakMethod<true, WeakPtr<T> > : public true_type {};
|
| -
|
| -// FunctionTraits<>
|
| +// The RunnableAdapter<> templates provide a uniform interface for invoking
|
| +// a function pointer, method pointer, or const method pointer. The adapter
|
| +// exposes a Run() method with an appropriate signature. Using this wrapper
|
| +// allows for writing code that supports all three pointer types without
|
| +// undue repetition. Without it, a lot of code would need to be repeated 3
|
| +// times.
|
| //
|
| -// The FunctionTraits<> template determines the type of function, and also
|
| -// creates a NormalizedType used to select the InvokerN classes. It turns out
|
| -// that syntactically, you only really have 2 variations when invoking a
|
| -// funciton pointer: normal, and method. One is invoked func_ptr(arg1). The
|
| -// other is invoked (*obj_->method_ptr(arg1)).
|
| +// For method pointers and const method pointers the first argument to Run()
|
| +// is considered to be the received of the method. This is similar to STL's
|
| +// mem_fun().
|
| //
|
| -// However, in the type system, there are many more distinctions. In standard
|
| -// C++, there's all variations of const, and volatile on the function pointer.
|
| -// In Windows, there are additional calling conventions (eg., __stdcall,
|
| -// __fastcall, etc.). FunctionTraits<> handles categorizing each of these into
|
| -// a normalized signature.
|
| +// This class also exposes a RunType typedef that is the function type of the
|
| +// Run() function.
|
| //
|
| -// Having a NormalizedSignature signature, reduces the combinatoric
|
| -// complexity of defintions for the InvokerN<> later. Even though there are
|
| -// only 2 syntactic variations on invoking a function, without normalizing the
|
| -// signature, there would need to be one specialization of InvokerN for each
|
| -// unique (function_type, bound_arg, unbound_args) tuple in order to match all
|
| -// function signatures.
|
| -//
|
| -// By normalizing the function signature, we reduce function_type to exactly 2.
|
| +// If and only if the wrapper contains a method or const method pointer, an
|
| +// IsMethod typedef is exposed. The existence of this typedef (NOT the value)
|
| +// marks that the wrapper should be considered a method wrapper.
|
|
|
| -template <typename Sig>
|
| -struct FunctionTraits;
|
| +template <typename Functor>
|
| +class RunnableAdapter;
|
|
|
| -$range ARITY 0..MAX_ARITY
|
| $for ARITY [[
|
| $range ARG 1..ARITY
|
|
|
| // Function: Arity $(ARITY).
|
| template <typename R[[]]
|
| -$if ARITY > 0[[, ]] $for ARG , [[typename X$(ARG)]]>
|
| -struct FunctionTraits<R(*)($for ARG , [[X$(ARG)]])> {
|
| - typedef R (*NormalizedSig)($for ARG , [[X$(ARG)]]);
|
| - typedef false_type IsMethod;
|
| -
|
| - typedef R Return;
|
| -
|
| -$if ARITY > 0 [[
|
| -
|
| - // Target type for each bound parameter.
|
| +$if ARITY > 0[[, ]] $for ARG , [[typename A$(ARG)]]>
|
| +class RunnableAdapter<R(*)($for ARG , [[A$(ARG)]])> {
|
| + public:
|
| + typedef R (RunType)($for ARG , [[A$(ARG)]]);
|
|
|
| -$for ARG [[
|
| - typedef X$(ARG) B$(ARG);
|
| + explicit RunnableAdapter(R(*function)($for ARG , [[A$(ARG)]]))
|
| + : function_(function) {
|
| + }
|
|
|
| -]] $$ for ARG
|
| -]] $$ if ARITY > 0
|
| + R Run($for ARG , [[typename CallbackParamTraits<A$(ARG)>::ForwardType a$(ARG)]]) {
|
| + return function_($for ARG , [[a$(ARG)]]);
|
| + }
|
|
|
| + private:
|
| + R (*function_)($for ARG , [[A$(ARG)]]);
|
| };
|
|
|
| // Method: Arity $(ARITY).
|
| template <typename R, typename T[[]]
|
| -$if ARITY > 0[[, ]] $for ARG , [[typename X$(ARG)]]>
|
| -struct FunctionTraits<R(T::*)($for ARG , [[X$(ARG)]])> {
|
| - typedef R (T::*NormalizedSig)($for ARG , [[X$(ARG)]]);
|
| +$if ARITY > 0[[, ]] $for ARG , [[typename A$(ARG)]]>
|
| +class RunnableAdapter<R(T::*)($for ARG , [[A$(ARG)]])> {
|
| + public:
|
| + typedef R (RunType)(T*[[]]
|
| +$if ARITY > 0[[, ]] $for ARG , [[A$(ARG)]]);
|
| typedef true_type IsMethod;
|
|
|
| - typedef R Return;
|
| -
|
| - // Target type for each bound parameter.
|
| - typedef T B1;
|
| -
|
| -$for ARG [[
|
| - typedef X$(ARG) B$(ARG + 1);
|
| + explicit RunnableAdapter(R(T::*method)($for ARG , [[A$(ARG)]]))
|
| + : method_(method) {
|
| + }
|
|
|
| -]] $$ for ARG
|
| + R Run(T* object[[]]
|
| +$if ARITY > 0[[, ]] $for ARG, [[typename CallbackParamTraits<A$(ARG)>::ForwardType a$(ARG)]]) {
|
| + return (object->*method_)($for ARG , [[a$(ARG)]]);
|
| + }
|
|
|
| + private:
|
| + R (T::*method_)($for ARG , [[A$(ARG)]]);
|
| };
|
|
|
| // Const Method: Arity $(ARITY).
|
| template <typename R, typename T[[]]
|
| -$if ARITY > 0[[, ]] $for ARG , [[typename X$(ARG)]]>
|
| -struct FunctionTraits<R(T::*)($for ARG , [[X$(ARG)]]) const> {
|
| - typedef R (T::*NormalizedSig)($for ARG , [[X$(ARG)]]);
|
| +$if ARITY > 0[[, ]] $for ARG , [[typename A$(ARG)]]>
|
| +class RunnableAdapter<R(T::*)($for ARG , [[A$(ARG)]]) const> {
|
| + public:
|
| + typedef R (RunType)(const T*[[]]
|
| +$if ARITY > 0[[, ]] $for ARG , [[A$(ARG)]]);
|
| typedef true_type IsMethod;
|
|
|
| - typedef R Return;
|
| + explicit RunnableAdapter(R(T::*method)($for ARG , [[A$(ARG)]]) const)
|
| + : method_(method) {
|
| + }
|
| +
|
| + R Run(const T* object[[]]
|
| +$if ARITY > 0[[, ]] $for ARG, [[typename CallbackParamTraits<A$(ARG)>::ForwardType a$(ARG)]]) {
|
| + return (object->*method_)($for ARG , [[a$(ARG)]]);
|
| + }
|
| +
|
| + private:
|
| + R (T::*method_)($for ARG , [[A$(ARG)]]) const;
|
| +};
|
| +
|
| +]] $$ for ARITY
|
| +
|
|
|
| - // Target type for each bound parameter.
|
| - typedef T B1;
|
| +// FunctionTraits<>
|
| +//
|
| +// Breaks a function signature apart into typedefs for easier introspection.
|
| +template <typename Sig>
|
| +struct FunctionTraits;
|
|
|
| +$for ARITY [[
|
| +$range ARG 1..ARITY
|
| +
|
| +template <typename R[[]]
|
| +$if ARITY > 0[[, ]] $for ARG , [[typename A$(ARG)]]>
|
| +struct FunctionTraits<R($for ARG , [[A$(ARG)]])> {
|
| + typedef R ReturnType;
|
| $for ARG [[
|
| - typedef X$(ARG) B$(ARG + 1);
|
|
|
| -]] $$ for ARG
|
| + typedef A$(ARG) A$(ARG)Type;
|
| +]]
|
|
|
| };
|
|
|
| -]] $$for ARITY
|
| +]]
|
|
|
| -// InvokerN<>
|
| -//
|
| -// The InvokerN templates contain a static DoInvoke() function that is the key
|
| -// to implementing type erasure in the Callback() classes.
|
| -//
|
| -// DoInvoke() is a static function with a fixed signature that is independent
|
| -// of StorageType; its first argument is a pointer to the non-templated common
|
| -// baseclass of StorageType. This lets us store pointer to DoInvoke() in a
|
| -// function pointer that has knowledge of the specific StorageType, and thus
|
| -// no knowledge of the bound function and bound parameter types.
|
| +
|
| +// ForceVoidReturn<>
|
| //
|
| -// As long as we ensure that DoInvoke() is only used with pointers there were
|
| -// upcasted from the correct StorageType, we can be sure that execution is
|
| -// safe.
|
| +// Set of templates that support forcing the function return type to void.
|
| +template <typename Sig>
|
| +struct ForceVoidReturn;
|
| +
|
| +$for ARITY [[
|
| +$range ARG 1..ARITY
|
| +
|
| +template <typename R[[]]
|
| +$if ARITY > 0[[, ]] $for ARG , [[typename A$(ARG)]]>
|
| +struct ForceVoidReturn<R($for ARG , [[A$(ARG)]])> {
|
| + typedef void(RunType)($for ARG , [[A$(ARG)]]);
|
| +};
|
| +
|
| +]] $$ for ARITY
|
| +
|
| +
|
| +// FunctorTraits<>
|
| //
|
| -// The InvokerN templates are the only point that knows the number of bound
|
| -// and unbound arguments. This is intentional because it allows the other
|
| -// templates classes in the system to only have as many specializations as
|
| -// the max arity of function we wish to support.
|
| +// See description at top of file.
|
| +template <typename T>
|
| +struct FunctorTraits {
|
| + typedef RunnableAdapter<T> RunnableType;
|
| + typedef typename RunnableType::RunType RunType;
|
| +};
|
|
|
| -$range BOUND 0..MAX_ARITY
|
| -$for BOUND [[
|
| +template <typename T>
|
| +struct FunctorTraits<IgnoreResultHelper<T> > {
|
| + typedef typename FunctorTraits<T>::RunnableType RunnableType;
|
| + typedef typename ForceVoidReturn<
|
| + typename RunnableType::RunType>::RunType RunType;
|
| +};
|
|
|
| -template <bool IsWeak, typename StorageType, typename NormalizedSig>
|
| -struct Invoker$(BOUND);
|
| +template <typename T>
|
| +struct FunctorTraits<Callback<T> > {
|
| + typedef Callback<T> RunnableType;
|
| + typedef typename Callback<T>::RunType RunType;
|
| +};
|
|
|
| -$range ARITY 0..MAX_ARITY
|
| -$for ARITY [[
|
|
|
| -$var UNBOUND = ARITY - BOUND
|
| -$if UNBOUND >= 0 [[
|
| +// MakeRunnable<>
|
| +//
|
| +// Converts a passed in functor to a RunnableType using type inference.
|
|
|
| -$$ Variables for function traits generation.
|
| -$range ARG 1..ARITY
|
| -$range BOUND_ARG 1..BOUND
|
| -$range UNBOUND_ARG (ARITY - UNBOUND + 1)..ARITY
|
| +template <typename T>
|
| +typename FunctorTraits<T>::RunnableType MakeRunnable(const T& t) {
|
| + return RunnableAdapter<T>(t);
|
| +}
|
|
|
| -$$ Variables for method traits generation. We are always short one arity since
|
| -$$ the first bound parameter is the object.
|
| -$var M_ARITY = ARITY - 1
|
| -$range M_ARG 1..M_ARITY
|
| -$range M_BOUND_ARG 2..BOUND
|
| -$range M_UNBOUND_ARG (M_ARITY - UNBOUND + 1)..M_ARITY
|
| +template <typename T>
|
| +typename FunctorTraits<T>::RunnableType
|
| +MakeRunnable(const IgnoreResultHelper<T>& t) {
|
| + return MakeRunnable(t.functor_);
|
| +}
|
|
|
| -// Function: Arity $(ARITY) -> $(UNBOUND).
|
| -template <typename StorageType, typename R[[]]
|
| -$if ARITY > 0 [[,]][[]]
|
| -$for ARG , [[typename X$(ARG)]]>
|
| -struct Invoker$(BOUND)<false, StorageType, R(*)($for ARG , [[X$(ARG)]])> {
|
| - typedef R(*DoInvokeType)(
|
| - internal::InvokerStorageBase*[[]]
|
| -$if UNBOUND != 0 [[, ]]
|
| -$for UNBOUND_ARG , [[typename internal::ParamTraits<X$(UNBOUND_ARG)>::ForwardType]]);
|
| +template <typename T>
|
| +const typename FunctorTraits<Callback<T> >::RunnableType&
|
| +MakeRunnable(const Callback<T>& t) {
|
| + return t;
|
| +}
|
|
|
| - static R DoInvoke(InvokerStorageBase* base[[]]
|
| -$if UNBOUND != 0 [[, ]][[]]
|
| -$for UNBOUND_ARG , [[typename internal::ParamTraits<X$(UNBOUND_ARG)>::ForwardType x$(UNBOUND_ARG)]]) {
|
| - StorageType* invoker = static_cast<StorageType*>(base);
|
| - return invoker->f_($for BOUND_ARG , [[Unwrap(invoker->p$(BOUND_ARG)_)]][[]]
|
| -$$ Add comma if there are both boudn and unbound args.
|
| -$if UNBOUND > 0 [[$if BOUND > 0 [[, ]]]][[]]
|
| -$for UNBOUND_ARG , [[x$(UNBOUND_ARG)]]);
|
| +
|
| +// InvokeHelper<>
|
| +//
|
| +// There are 3 logical InvokeHelper<> specializations: normal, void-return,
|
| +// WeakCalls.
|
| +//
|
| +// The normal type just calls the underlying runnable.
|
| +//
|
| +// We need a InvokeHelper to handle void return types in order to support
|
| +// IgnoreResult(). Normally, if the Runnable's RunType had a void return,
|
| +// the template system would just accept "return functor.Run()" ignoring
|
| +// the fact that a void function is being used with return. This piece of
|
| +// sugar breaks though when the Runnable's RunType is not void. Thus, we
|
| +// need a partial specialization to change the syntax to drop the "return"
|
| +// from the invocation call.
|
| +//
|
| +// WeakCalls similarly need special syntax that is applied to the first
|
| +// argument to check if they should no-op themselves.
|
| +template <bool IsWeakCall, typename ReturnType, typename Runnable,
|
| + typename ArgsType>
|
| +struct InvokeHelper;
|
| +
|
| +$for ARITY [[
|
| +$range ARG 1..ARITY
|
| +
|
| +template <typename ReturnType, typename Runnable[[]]
|
| +$if ARITY > 0 [[,]] $for ARG , [[typename A$(ARG)]]>
|
| +struct InvokeHelper<false, ReturnType, Runnable,
|
| + void($for ARG , [[A$(ARG)]])> {
|
| + static ReturnType MakeItSo(Runnable runnable[[]]
|
| +$if ARITY > 0[[, ]] $for ARG , [[A$(ARG) a$(ARG)]]) {
|
| + return runnable.Run($for ARG , [[a$(ARG)]]);
|
| }
|
| };
|
|
|
| -$if BOUND > 0 [[
|
| -
|
| -// Method: Arity $(M_ARITY) -> $(UNBOUND).
|
| -template <typename StorageType, typename R, typename T[[]]
|
| -$if M_ARITY > 0[[, ]] $for M_ARG , [[typename X$(M_ARG)]]>
|
| -struct Invoker$(BOUND)<false, StorageType, R(T::*)($for M_ARG , [[X$(M_ARG)]])> {
|
| - typedef R(*DoInvokeType)(
|
| - internal::InvokerStorageBase*[[]]
|
| -$if UNBOUND != 0 [[, ]]
|
| -$for M_UNBOUND_ARG , [[typename internal::ParamTraits<X$(M_UNBOUND_ARG)>::ForwardType]]);
|
| -
|
| - static R DoInvoke(InvokerStorageBase* base[[]]
|
| -$if UNBOUND > 0 [[, ]][[]]
|
| -$for M_UNBOUND_ARG , [[typename internal::ParamTraits<X$(M_UNBOUND_ARG)>::ForwardType x$(M_UNBOUND_ARG)]]) {
|
| - StorageType* invoker = static_cast<StorageType*>(base);
|
| - return (Unwrap(invoker->p1_)->*invoker->f_)([[]]
|
| -$for M_BOUND_ARG , [[Unwrap(invoker->p$(M_BOUND_ARG)_)]][[]]
|
| -$if UNBOUND > 0 [[$if BOUND > 1 [[, ]]]][[]]
|
| -$for M_UNBOUND_ARG , [[x$(M_UNBOUND_ARG)]]);
|
| +template <typename Runnable[[]]
|
| +$if ARITY > 0 [[,]] $for ARG , [[typename A$(ARG)]]>
|
| +struct InvokeHelper<false, void, Runnable,
|
| + void($for ARG , [[A$(ARG)]])> {
|
| + static void MakeItSo(Runnable runnable[[]]
|
| +$if ARITY > 0[[, ]] $for ARG , [[A$(ARG) a$(ARG)]]) {
|
| + runnable.Run($for ARG , [[a$(ARG)]]);
|
| }
|
| };
|
|
|
| -// WeakPtr Method: Arity $(M_ARITY) -> $(UNBOUND).
|
| -template <typename StorageType, typename T[[]]
|
| -$if M_ARITY > 0[[, ]] $for M_ARG , [[typename X$(M_ARG)]]>
|
| -struct Invoker$(BOUND)<true, StorageType, void(T::*)($for M_ARG , [[X$(M_ARG)]])> {
|
| - typedef void(*DoInvokeType)(
|
| - internal::InvokerStorageBase*[[]]
|
| -$if UNBOUND != 0 [[, ]]
|
| -$for M_UNBOUND_ARG , [[typename internal::ParamTraits<X$(M_UNBOUND_ARG)>::ForwardType]]);
|
| -
|
| - static void DoInvoke(InvokerStorageBase* base[[]]
|
| -$if UNBOUND > 0 [[, ]][[]]
|
| -$for M_UNBOUND_ARG , [[typename internal::ParamTraits<X$(M_UNBOUND_ARG)>::ForwardType x$(M_UNBOUND_ARG)]]) {
|
| - StorageType* invoker = static_cast<StorageType*>(base);
|
| - typename StorageType::P1Traits::StorageType& weak_ptr = invoker->p1_;
|
| - if (!weak_ptr.get()) {
|
| +$if ARITY > 0 [[
|
| +
|
| +template <typename Runnable[[]], $for ARG , [[typename A$(ARG)]]>
|
| +struct InvokeHelper<true, void, Runnable,
|
| + void($for ARG , [[A$(ARG)]])> {
|
| + static void MakeItSo(Runnable runnable[[]]
|
| +$if ARITY > 0[[, ]] $for ARG , [[A$(ARG) a$(ARG)]]) {
|
| + if (!a1.get()) {
|
| return;
|
| }
|
| - (weak_ptr->*invoker->f_)([[]]
|
| -$for M_BOUND_ARG , [[Unwrap(invoker->p$(M_BOUND_ARG)_)]][[]]
|
| -$if UNBOUND > 0 [[$if BOUND > 1 [[, ]]]][[]]
|
| -$for M_UNBOUND_ARG , [[x$(M_UNBOUND_ARG)]]);
|
| +
|
| + runnable.Run($for ARG , [[a$(ARG)]]);
|
| }
|
| };
|
|
|
| -]] $$ if BOUND
|
| +]]
|
|
|
| -]] $$ if UNBOUND
|
| -]] $$ for ARITY
|
| -]] $$ for BOUND
|
| +]] $$ for ARITY
|
|
|
| -// BindMoreFuncN<>
|
| -//
|
| -// This set of functions help in fully binding the free parameters in a
|
| -// Callback<>.
|
| -$for BOUND [[
|
| -$range BOUND_ARG 1..BOUND
|
| -$if BOUND != 0 [[
|
| +#if !defined(_MSC_VER)
|
|
|
| -template <typename Sig, $for BOUND_ARG , [[typename P$(BOUND_ARG)]]>
|
| -void BindMoreFunc$(BOUND)(const base::Callback<Sig>& callback, [[]]
|
| -$for BOUND_ARG , [[const P$(BOUND_ARG)& p$(BOUND_ARG)]]) {
|
| - callback.Run($for BOUND_ARG , [[p$(BOUND_ARG)]]);
|
| -}
|
| +template <typename ReturnType, typename Runnable, typename ArgsType>
|
| +struct InvokeHelper<true, ReturnType, Runnable, ArgsType> {
|
| + // WeakCalls are only supported for functions with a void return type.
|
| + // Otherwise, the function result would be undefined if the the WeakPtr<>
|
| + // is invalidated.
|
| + COMPILE_ASSERT(is_void<ReturnType>::value,
|
| + weak_ptrs_can_only_bind_to_methods_without_return_values);
|
| +};
|
|
|
| -]] $$ if BOUND
|
| -]] $$ for BOUND
|
| +#endif
|
|
|
| -// InvokerStorageN<>
|
| -//
|
| -// These are the actual storage classes for the Invokers.
|
| -//
|
| -// Though these types are "classes", they are being used as structs with
|
| -// all member variable public. We cannot make it a struct because it inherits
|
| -// from a class which causes a compiler warning. We cannot add a "Run()" method
|
| -// that forwards the unbound arguments because that would require we unwrap the
|
| -// Sig type like in InvokerN above to know the return type, and the arity
|
| -// of Run().
|
| +// Invoker<>
|
| //
|
| -// An alternate solution would be to merge InvokerN and InvokerStorageN,
|
| -// but the generated code seemed harder to read.
|
| +// See description at the top of the file.
|
| +template <int NumBound, typename Storage, typename RunType>
|
| +struct Invoker;
|
|
|
| +$for ARITY [[
|
| +
|
| +$$ Number of bound arguments.
|
| +$range BOUND 0..ARITY
|
| $for BOUND [[
|
| +
|
| +$var UNBOUND = ARITY - BOUND
|
| +$range ARG 1..ARITY
|
| $range BOUND_ARG 1..BOUND
|
| +$range UNBOUND_ARG (ARITY - UNBOUND + 1)..ARITY
|
|
|
| -template <typename Sig[[]]
|
| -$if BOUND > 0 [[, ]]
|
| -$for BOUND_ARG , [[typename P$(BOUND_ARG)]]>
|
| -class InvokerStorage$(BOUND) : public InvokerStorageBase {
|
| - public:
|
| - typedef InvokerStorage$(BOUND) StorageType;
|
| - typedef FunctionTraits<Sig> TargetTraits;
|
| - typedef typename TargetTraits::IsMethod IsMethod;
|
| - typedef Sig Signature;
|
| +// Arity $(ARITY) -> $(UNBOUND).
|
| +template <typename StorageType, typename R[[]]
|
| +$if ARITY > 0 [[,]][[]]
|
| +$for ARG , [[typename X$(ARG)]]>
|
| +struct Invoker<$(BOUND), StorageType, R($for ARG , [[X$(ARG)]])> {
|
| + typedef R(RunType)(BindStateBase*[[]]
|
| +$if UNBOUND != 0 [[, ]]
|
| +$for UNBOUND_ARG , [[typename CallbackParamTraits<X$(UNBOUND_ARG)>::ForwardType]]);
|
|
|
| -$for BOUND_ARG [[
|
| - typedef ParamTraits<P$(BOUND_ARG)> P$(BOUND_ARG)Traits;
|
| + typedef R(UnboundRunType)($for UNBOUND_ARG , [[X$(UNBOUND_ARG)]]);
|
|
|
| + static R Run(BindStateBase* base[[]]
|
| +$if UNBOUND != 0 [[, ]][[]]
|
| +$for UNBOUND_ARG , [[
|
| +typename CallbackParamTraits<X$(UNBOUND_ARG)>::ForwardType x$(UNBOUND_ARG)
|
| +]][[]]
|
| +) {
|
| + StorageType* storage = static_cast<StorageType*>(base);
|
| +
|
| + // Local references to make debugger stepping easier. If in a debugger,
|
| + // you really want to warp ahead and step through the
|
| + // InvokeHelper<>::MakeItSo() call below.
|
| +$for BOUND_ARG
|
| +[[
|
| +
|
| + typedef typename StorageType::Bound$(BOUND_ARG)UnwrapTraits Bound$(BOUND_ARG)UnwrapTraits;
|
| ]]
|
|
|
| -$if BOUND == 0 [[
|
| - typedef Invoker$(BOUND)<false, StorageType,
|
| - typename TargetTraits::NormalizedSig> Invoker;
|
| -]] $else [[
|
| - typedef Invoker$(BOUND)<IsWeakMethod<IsMethod::value, P1>::value, StorageType,
|
| - typename TargetTraits::NormalizedSig> Invoker;
|
| - COMPILE_ASSERT(!(IsWeakMethod<IsMethod::value, P1>::value) ||
|
| - is_void<typename TargetTraits::Return>::value,
|
| - weak_ptrs_can_only_bind_to_methods_without_return_values);
|
| +
|
| +$for BOUND_ARG
|
| +[[
|
| +
|
| + typename Bound$(BOUND_ARG)UnwrapTraits::ForwardType x$(BOUND_ARG) =
|
| + Bound$(BOUND_ARG)UnwrapTraits::Unwrap(storage->p$(BOUND_ARG)_);
|
| ]]
|
|
|
| + return InvokeHelper<StorageType::IsWeakCall::value, R,
|
| + typename StorageType::RunnableType,
|
| + void(
|
| +$for BOUND_ARG , [[
|
| +typename Bound$(BOUND_ARG)UnwrapTraits::ForwardType
|
| +]]
|
|
|
| -$for BOUND_ARG [[
|
| -$if BOUND_ARG == 1 [[
|
| +$if UNBOUND > 0 [[$if BOUND > 0 [[, ]]]][[]]
|
|
|
| - // For methods, we need to be careful for parameter 1. We skip the
|
| - // scoped_refptr check because the binder itself takes care of this. We also
|
| - // disallow binding of an array as the method's target object.
|
| - COMPILE_ASSERT(IsMethod::value ||
|
| - internal::NeedsScopedRefptrButGetsRawPtr<
|
| - typename ParamTraits<P$(BOUND_ARG)>::StorageType>::value == 0,
|
| - p$(BOUND_ARG)_is_refcounted_type_and_needs_scoped_refptr);
|
| - COMPILE_ASSERT(!IsMethod::value || !is_array<P$(BOUND_ARG)>::value,
|
| - first_bound_argument_to_method_cannot_be_array);
|
| -]] $else [[
|
| +$for UNBOUND_ARG , [[
|
| +typename CallbackParamTraits<X$(UNBOUND_ARG)>::ForwardType x$(UNBOUND_ARG)
|
| +]]
|
| +)>
|
| + ::MakeItSo(storage->runnable_
|
| +$if ARITY > 0[[, ]] $for ARG , [[x$(ARG)]]);
|
| + }
|
| +};
|
| +
|
| +]] $$ for BOUND
|
| +]] $$ for ARITY
|
|
|
| - COMPILE_ASSERT(internal::NeedsScopedRefptrButGetsRawPtr<
|
| - typename ParamTraits<P$(BOUND_ARG)>::StorageType>::value == 0,
|
| - p$(BOUND_ARG)_is_refcounted_type_and_needs_scoped_refptr);
|
| -]] $$ $if BOUND_ARG
|
| -]] $$ $for BOUND_ARG
|
|
|
| +// BindState<>
|
| +//
|
| +// This stores all the state passed into Bind() and is also where most
|
| +// of the template resolution magic occurs.
|
| +//
|
| +// Runnable is the functor we are binding arguments to.
|
| +// RunType is type of the Run() function that the Invoker<> should use.
|
| +// Normally, this is the same as the RunType of the Runnable, but it can
|
| +// be different if an adapter like IgnoreResult() has been used.
|
| +//
|
| +// BoundArgsType contains the storage type for all the bound arguments by
|
| +// (ab)using a function type.
|
| +template <typename Runnable, typename RunType, typename BoundArgsType>
|
| +struct BindState;
|
|
|
| -$if BOUND > 0 [[
|
| +$for ARITY [[
|
| +$range ARG 1..ARITY
|
|
|
| - // Do not allow binding a non-const reference parameter. Non-const reference
|
| - // parameters are disallowed by the Google style guide. Also, binding a
|
| - // non-const reference parameter can make for subtle bugs because the
|
| - // invoked function will receive a reference to the stored copy of the
|
| - // argument and not the original.
|
| - COMPILE_ASSERT(
|
| - !($for BOUND_ARG || [[ is_non_const_reference<typename TargetTraits::B$(BOUND_ARG)>::value ]]),
|
| - do_not_bind_functions_with_nonconst_ref);
|
| +template <typename Runnable, typename RunType[[]]
|
| +$if ARITY > 0[[, ]] $for ARG , [[typename P$(ARG)]]>
|
| +struct BindState<Runnable, RunType, void($for ARG , [[P$(ARG)]])> : public BindStateBase {
|
| + typedef Runnable RunnableType;
|
|
|
| +$if ARITY > 0 [[
|
| + typedef IsWeakMethod<HasIsMethodTag<Runnable>::value, P1> IsWeakCall;
|
| +]] $else [[
|
| + typedef false_type IsWeakCall;
|
| ]]
|
|
|
| + typedef Invoker<$(ARITY), BindState, RunType> InvokerType;
|
| + typedef typename InvokerType::UnboundRunType UnboundRunType;
|
| +
|
| +$if ARITY > 0 [[
|
| +
|
| + // Convenience typedefs for bound argument types.
|
| +
|
| +$for ARG [[
|
| + typedef UnwrapTraits<P$(ARG)> Bound$(ARG)UnwrapTraits;
|
| +
|
| +]] $$ for ARG
|
| +
|
| +
|
| +]] $$ if ARITY > 0
|
|
|
| - InvokerStorage$(BOUND)(Sig f
|
| -$if BOUND > 0 [[, ]]
|
| -$for BOUND_ARG , [[const P$(BOUND_ARG)& p$(BOUND_ARG)]])
|
| - : f_(f)[[]]
|
| -$if BOUND == 0 [[
|
| +$$ The extra [[ ]] is needed to massage spacing. Silly pump.py.
|
| +[[ ]]$if ARITY == 0 [[explicit ]]BindState(const Runnable& runnable
|
| +$if ARITY > 0 [[, ]] $for ARG , [[const P$(ARG)& p$(ARG)]])
|
| + : runnable_(runnable)[[]]
|
| +$if ARITY == 0 [[
|
| {
|
|
|
| ]] $else [[
|
| -, $for BOUND_ARG , [[p$(BOUND_ARG)_(static_cast<typename ParamTraits<P$(BOUND_ARG)>::StorageType>(p$(BOUND_ARG)))]] {
|
| - MaybeRefcount<IsMethod, P1>::AddRef(p1_);
|
| +, $for ARG , [[
|
| +
|
| + p$(ARG)_(p$(ARG))
|
| +]] {
|
| + MaybeRefcount<HasIsMethodTag<Runnable>::value, P1>::AddRef(p1_);
|
|
|
| ]]
|
| }
|
|
|
| - virtual ~InvokerStorage$(BOUND)() {
|
| -$if BOUND > 0 [[
|
| -
|
| - MaybeRefcount<IsMethod, P1>::Release(p1_);
|
| -
|
| + virtual ~BindState() {
|
| +$if ARITY > 0 [[
|
| + MaybeRefcount<HasIsMethodTag<Runnable>::value, P1>::Release(p1_);
|
| ]]
|
| }
|
|
|
| - Sig f_;
|
| + RunnableType runnable_;
|
|
|
| -$for BOUND_ARG [[
|
| - typename ParamTraits<P$(BOUND_ARG)>::StorageType p$(BOUND_ARG)_;
|
| +$for ARG [[
|
| + P$(ARG) p$(ARG)_;
|
|
|
| ]]
|
| };
|
|
|
| -]] $$ for BOUND
|
| +]] $$ for ARITY
|
|
|
| } // namespace internal
|
| } // namespace base
|
|
|