Rogue Wave banner
Previous fileTop of DocumentContentsIndexNext file

rwtMakeFunctorR1


Global Functions and Macros

Data Type and Member Function Indexes
(exclusive of constructors and destructors)

Member Functions

Package

Functor

Header File

#include <rw/functor/functorR1.h>

Description

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

The rwtMakeFunctorR1 functions and macros are provided to construct functors based on the RWTFunctorR1<SR,S1> class. The RWTFunctorR1<SR,S1> class acts as the handle for a family of functor implementation classes based on the RWTFunctorR1Imp<SR,S1> class. A functor based on RWTFunctorR1<SR,S1> is invoked with one argument and returns a value of type SR, while the implementation classes can accept functions with up to two additional arguments. The values for the additional arguments are defined when an implementation class instance is constructed, and are passed to the function each time the functor is invoked.

Each rwtMakeFunctorR1 function or macro instantiates and constructs an appropriate functor implementation class instance and returns an RWTFunctorR1<SR,S1> handle that is bound to that instance.

rwtMakeFunctorR1 comes in two flavors. First, there is a set of overloaded global function templates. Since not all compilers are able to handle templates to the degree required by these functions, we also provide a corresponding set of macros. The template functions are slightly easier to use and you only have to remember one name. The macros are more portable but they do require more arguments; and because we cannot overload macros, each must have a unique name.

In naming the macros we have employed a convention to make the names easier to remember. Each name begins with rwtMakeFunctorR1, which will be followed by either a G if the macro is expecting a global function, or an M if it is expecting a member function. At that point the name is complete if the associated global or member function takes no additional arguments. Otherwise we add one of A1 or A2 for functions with 1 or 2 additional arguments respectively. For example, you will use macro rwtMakeFunctorR1G to create a functor that calls a global function that takes no additional arguments. The macro rwtMakeFunctorR1MA2 will create a functor that calls a member function that takes two additional arguments.

Example Using Templates

Example Using Macros

Global Function Templates

The following information applies to each of the function templates in this section:

template <class SR, class S1, class DR, class D1>
RWTFunctorR1<SR,S1> 
rwtMakeFunctorR1(SR (*invokeAs)(S1), DR (*function)(D1));
template <class SR, class S1, class DR, class D1, 
class A1, class AA1> RWTFunctorR1<SR,S1> rwtMakeFunctorR1(SR (*invokeAs)(S1),
DR (*function)(D1,A1), AA1 a1)
template <class SR, class S1, class DR, class D1, 
class A1, class A2, class AA1, class AA2> RWTFunctorR1<SR,S1> rwtMakeFunctorR1(SR (*invokeAs)(S1),
DR (*function)(D1,A1,A2), AA1 a1, AA2 a2)
template <class SR, class S1, class Callee, 
class DR, class D1> RWTFunctorR1<SR,S1> rwtMakeFunctorR1(SR(*invokeAs)(S1), Callee& callee,
DR (Callee::*function)(D1))
template <class SR, class S1, class Callee, class DR, 
class D1, class A1, class AA1> RWTFunctorR1<SR,S1> rwtMakeFunctorR1(SR(*invokeAs)(S1), Callee& callee,
DR (Callee::*function)(D1,A1), AA1 a1)
template <class SR, class S1, class Callee, class DR, 
class D1,class A1,class A2, class AA1, class AA2> RWTFunctorR1<SR,S1> rwtMakeFunctorR1(SR(*invokeAs)(S1), Callee& callee,
DR (Callee::*function)(D1,A1,A2), AA1 a1, AA2 a2)

Macros for Use With
Global Functions

The macros in this section use the following naming conventions for the macro arguments:

rwtMakeFunctorR1G(SR,S1,DR,function,D1)
rwtMakeFunctorR1GA1(SR,S1,DR,function,D1,A1,a1)
rwtMakeFunctorR1GA2(SR,S1,DR,function,D1,A1,a1,A2,a2)

Macros for Use With Member Functions

The macros in this section use the following naming conventions for the macro arguments:

rwtMakeFunctorR1M(SR,S1,Callee,callee,DR,function,D1) 
rwtMakeFunctorR1MA1(SR,S1,Callee,callee,DR,function,D1,A1,a1) 
rwtMakeFunctorR1MA2(SR,S1,Callee,callee,
DR,function,D1,A1,a1,A2,a2)

See Also

RWTFunctorR1<SR,S1>, RWTFunctorR1Imp<SR,S1>



Previous fileTop of DocumentContentsIndexNext file

©Copyright 2000, Rogue Wave Software, Inc.
Contact Rogue Wave about documentation or support issues.