Function like object hosting a list of FunctionPointerWithContext. More...

#include <CallChainOfFunctionPointersWithContext.h>

Inheritance diagram for CallChainOfFunctionPointersWithContext< ContextType >:

Public Types
typedef FunctionPointerWithContext< ContextType > *	pFunctionPointerWithContext_t
	Alias of the FunctionPointerWithContext type this object can store. More...

Public Member Functions
	CallChainOfFunctionPointersWithContext ()
	Create an empty callchain. More...

virtual	~CallChainOfFunctionPointersWithContext ()
	Destruction of the callchain. More...

pFunctionPointerWithContext_t	add (void(*function)(ContextType context))
	Add a function pointer at the front of the chain. More...

template<typename T >
pFunctionPointerWithContext_t	add (T tptr, void(T::mptr)(ContextType context))
	Add a member function bound to its instance at the front of the chain. More...

pFunctionPointerWithContext_t	add (const FunctionPointerWithContext< ContextType > &func)
	Add a FunctionPointerWithContext at the front of the chain. More...

bool	detach (const FunctionPointerWithContext< ContextType > &toDetach)
	Detach a function pointer from a callchain. More...

void	clear (void)
	Remove all functions registered in the chain. More...

bool	hasCallbacksAttached (void) const
	Check whether the callchain contains any callbacks. More...

void	call (ContextType context)
	Call sequentially each member of the chain. More...

void	call (ContextType context) const
	Call sequentially each member of the chain. More...

void	operator() (ContextType context) const
	Call sequentially each member of the chain. More...

bool	toBool () const
	Test if the callchain is empty or not. More...

	operator BoolType_t () const
	Bool operator implementation, derived class must provide a bool toBool() const function. More...

Protected Types
typedef void(base::*	BoolType_t) () const
	The bool type is a pointer to method that can be used in boolean context. More...

Protected Member Functions
void	invalidTag () const
	Nonimplemented call, use to disallow conversion between unrelated types. More...

void	trueTag () const
	Special member function that indicates a true value. More...

Detailed Description

template<typename ContextType>
class CallChainOfFunctionPointersWithContext< ContextType >

Function like object hosting a list of FunctionPointerWithContext.

Upon call, each FunctionPointerWithContext instance present in the object will be called in sequence with the initial parameters.

It can be seen as a variation of the observer pattern this object being the observable, instances of the FunctionPointerWithContext being the observable and the notify/update operation being the function call.

Example:

CallChainOfFunctionPointersWithContext<void *> chain;
void first(void *context) {
    printf("'first' function.\n");
}
void second(void *context) {
    printf("'second' function.\n");
}
class Test {
public:
    void f(void *context) {
        printf("A::f (class member).\n");
    }
};
int main() {
    Test test;
    chain.add(second);
    chain.add_front(first);
    chain.add(&test, &Test::f);
    // will print:
    // 'second' function.
    // 'first' function.
    // A::f (class member).
    chain.call();
}

Note: memory allocation is used to add new function like objects into the call chain.

Template Parameters

ContextType Type of the parameter accepted by the callbacks hosted in the object.

Definition at line 82 of file CallChainOfFunctionPointersWithContext.h.

Member Typedef Documentation

typedef void(base::* BoolType_t) () const

protectedinherited

The bool type is a pointer to method that can be used in boolean context.

Definition at line 48 of file SafeBool.h.

typedef FunctionPointerWithContext<ContextType>* pFunctionPointerWithContext_t

Alias of the FunctionPointerWithContext type this object can store.

Definition at line 88 of file CallChainOfFunctionPointersWithContext.h.

Constructor & Destructor Documentation

CallChainOfFunctionPointersWithContext ( )

Create an empty callchain.

Definition at line 94 of file CallChainOfFunctionPointersWithContext.h.

virtual ~CallChainOfFunctionPointersWithContext ( )

virtual

Destruction of the callchain.

Definition at line 99 of file CallChainOfFunctionPointersWithContext.h.

Member Function Documentation

pFunctionPointerWithContext_t add ( void(*)(ContextType context) function )

Add a function pointer at the front of the chain.

Parameters

[in] function A pointer to a void function.

Returns: The FunctionPointerWithContext object created from function.

Definition at line 111 of file CallChainOfFunctionPointersWithContext.h.

pFunctionPointerWithContext_t add	(	T *	tptr,
		void(T::*)(ContextType context)	mptr
	)

Add a member function bound to its instance at the front of the chain.

Parameters

[in]	tptr	Pointer to the object to call the member function on.
[in]	mptr	Pointer to the member function to be called.

Returns: The FunctionPointerWithContext object created from tptr and mptr.

Definition at line 126 of file CallChainOfFunctionPointersWithContext.h.

pFunctionPointerWithContext_t add ( const FunctionPointerWithContext< ContextType > & func )

Add a FunctionPointerWithContext at the front of the chain.

Parameters

[in] func The FunctionPointerWithContext to add.

Returns: The function object created for func.

Definition at line 138 of file CallChainOfFunctionPointersWithContext.h.

void call ( ContextType context )

Call sequentially each member of the chain.

Parameters

[in] context Parameter to pass to the functions called.

Definition at line 213 of file CallChainOfFunctionPointersWithContext.h.

void call ( ContextType context ) const

Call sequentially each member of the chain.

Parameters

[in] context Parameter to pass to the functions called.

Definition at line 223 of file CallChainOfFunctionPointersWithContext.h.

void clear ( void )

Remove all functions registered in the chain.

Definition at line 186 of file CallChainOfFunctionPointersWithContext.h.

bool detach ( const FunctionPointerWithContext< ContextType > & toDetach )

Detach a function pointer from a callchain.

Parameters

[in] toDetach FunctionPointerWithContext instance to detach from this callchain.

Returns: true if a function pointer has been detached and false otherwise.

Note: It is safe to remove a function pointer while call(ContextType) is traversing the chain.

Definition at line 154 of file CallChainOfFunctionPointersWithContext.h.

bool hasCallbacksAttached ( void ) const

Check whether the callchain contains any callbacks.

Returns: true if the callchain is not empty and false otherwise.

Definition at line 203 of file CallChainOfFunctionPointersWithContext.h.

void invalidTag ( ) const

protectedinherited

Nonimplemented call, use to disallow conversion between unrelated types.

operator BoolType_t ( ) const

inherited

Bool operator implementation, derived class must provide a bool toBool() const function.

Definition at line 117 of file SafeBool.h.

void operator() ( ContextType context ) const

Call sequentially each member of the chain.

Parameters

[in] context Parameter to pass to the functions called.

void first(bool);
void second(bool);
CallChainOfFunctionPointerWithContext<bool> foo;
foo.attach(first);
foo.attach(second);
// call the callchain like a function
foo(true);

Definition at line 258 of file CallChainOfFunctionPointersWithContext.h.

bool toBool ( ) const

Test if the callchain is empty or not.

Returns: true if the callchain is not empty and false otherwise.

Note: used by SafeBool to offer a safe boolean conversion.

CallChainOfFunctionPointersWithContext<void *> chain;
if (!chain) {
  // Do something if the chain is empty.
}
if (chain) {
  // Do something if the chain is not empty.
}

Definition at line 283 of file CallChainOfFunctionPointersWithContext.h.

void trueTag ( ) const

protectedinherited

Special member function that indicates a true value.

Definition at line 58 of file SafeBool.h.

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Detailed Description

template<typename ContextType> class CallChainOfFunctionPointersWithContext< ContextType >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Important Information for this Arm website

template<typename ContextType>
class CallChainOfFunctionPointersWithContext< ContextType >