RWTFunctor1Imp< S1 > Class Template Reference
[Functors]

Abstract base class for the family of functor bodies that are invoked with one argument and return no value. More...

#include <rw/functor/RWTFunctor1Imp.h>

Inheritance diagram for RWTFunctor1Imp< S1 >:

List of all members.

---

Detailed Description

template<class S1>
class RWTFunctor1Imp< S1 >

A function object, or a functor, encapsulates a call to an associated global or member function. When a functor is invoked, it calls the associated function.

RWTFunctor1Imp<S1> is the abstract base class for the family of functor bodies that are invoked with one argument and return no value.

Each derived class name appends either a G (for global) or an M (for member), to indicate whether it is invoked upon an object. Static member functions use the G version since there is no object associated with the call.

The class name may also append A1 or A2, to indicate at construction that it takes callee arguments. These arguments are stored in the functor body and then added to the caller argument at invocation time.

The six concrete class names are:

• RWTFunctor1GImp<S1,DR,D1>
  • No this object, no callee arguments

• RWTFunctor1GA1Imp<S1,DR,D1,A1>
  • No this object, one callee argument

• RWTFunctor1GA2Imp<S1,DR,D1,A1,A2>
  • No this object, one callee argument

• RWTFunctor1MImp<S1,Callee,DR,D1>
  • Has this object, but no callee arguments

• RWTFunctor1MA1Imp<S1,Callee,D1,DR,A1>
  • Has this object, and one callee argument

• RWTFunctor1MA2Imp<S1,Callee,DR,D1,A1,A2>
  • Has this object, and two callee arguments

These concrete classes are templatized on the signature of the function that is encapsulated, as well as on the signature of the functor invocation.

The template parameters describe the invocation signature of the functor and the function call it encapsulates. These parameters are:

• S1  The type of the first functor signature argument

• Callee  The class type that declares a member function

• DR      The return type of the function

• D1      The type of the first function signature argument; the compiler must be able to convert to this from the S1 type.

• A1      The type of the first client data argument

• A2      The type of the second client data argument

The make() function is the only member of these functor classes that is intended to be accessed directly; it is often called through one of the rwtMakeFunctor1() convenience mechanisms. All other members must be accessed through an RWTFunctor1<S1> handle.

Examples

 #include <rw/functor/RWTFunctor1GImp.h>
 
 void foo(int);
 
 // Create a functor that calls foo():
 RWTFunctor1<int> func = RWTFunctor1GImp<int,void,int>::make(foo);
 // Invoke Functor
 func(7);

See also:

rwtMakeFunctor1(), RWTFunctor1<S1>