RWTFunctorR0<SR>

Module:  Threads   Package:  Functor

RWTFunctorR0<SR>   RWHandleBase 

• Local Index
• Header File
• Description
• Example
• Public Typedefs
• Public Constructors
• Public Destructor
• Public Operators
• Protected Member Function
• See Also

Members

body() CallerSignature

operator()() operator=()

RWTFunctorR0() SRType

~RWTFunctorR0()

#include <rw/functor/functorR0.h>

RWTFunctorR0<SR> represents the group of functors that are invoked without any arguments, and whose invocation returns a value.

A function object, or a 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.

Instances of RWTFunctorR0 act as handles to functor implementations or bodies. Such implementations are created by using either the rwtMakeFunctorR0() global functions or macros. Each of these methods creates a new body instance, and returns the handle to that instance. See the example below.

Note that although an instance of this class is invoked with no arguments, the encapsulated function may have up to 3 arguments.

The arguments that will be passed to the encapsulated function are provided to the functor at the time of creation. They are stored within the functor object, and are retrieved at the time of invocation.

#include <rw/functor/functorR0.h>

// A function to be encapsulated in a functor.
int flag=0;
int getFlag(){ return flag; }

int main () {

   // Create a handle ('functor'), and assign a body to it.
   RWTFunctorR0 functor = rwtMakeFunctorR0((int(*)(void))0, getFlag);

   // Invoking the functor will return the value of flag
   int flag_value = functor();

   return 0;
}

typedef SR (*CallerSignature)();

The signature of the functor invocation.

typedef SR SRType;

The return type of the functor.

RWTFunctorR0();

Constructs an empty, invalid, handle instance. To create a viable handle use the rwtMakeFunctor1() global functions or macros.

RWTFunctorR0(RWStaticCtor);

Constructs a global static handle instance. Constructor will not reset any values that may have been set in invocations prior to the constructor call.

RWTFunctorR0(RWTFunctorR1Imp<SR>* functorImp);

Body constructor. Binds a new handle instance to an existing functor body instance.

RWTFunctorR0(const RWTFunctorR0<SR>& second);

Copy constructor. Binds a new handle instance to the functor body instance, if any, associated with the second handle instance.

~RWTFunctorR0();

Destructor.

RWTFunctorR0<SR>& 
operator=(const RWTFunctorR0<SR>& second);

Assignment operator. Detaches this handle instance from any functor body instance it currently references, and binds it to the functor body instance, if any, associated with the second handle instance.

SR 
operator()() const;

Invokes the functor, calling the encapsulated function. Throws an RWTHRInvalidPointer if the handle has no associated body.

RWTFunctorR0Imp<SR>&
body() const;

Gets a reference for the body instance, if any; otherwise, throws an RWTHRInvalidPointer exception.

rwtMakeFunctorR0()

© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.