Delegate member functions of a C++ class to externally-specified functions. More...

#include <Delegator.h>

Inheritance diagram for Delegator:

Public Member Functions
void	setDelegate (const std::string &name, const std::function< void()> &func, const std::string &when)
	Set delegates for member functions with the signature `void()`. More...

void	setDelegate (const std::string &name, const std::function< void(bool)> &func, const std::string &when)
	set delegates for member functions with the signature `void(bool)` More...

void	setDelegate (const std::string &name, const std::function< void(double)> &func, const std::string &when)
	set delegates for member functions with the signature `void(double)` More...

void	setDelegate (const std::string &name, const std::function< void(std::array< size_t, 1 >, double *)> &func, const std::string &when)
	Set delegates for member functions with the signature `void(double*)` More...

void	setDelegate (const std::string &name, const std::function< void(std::array< size_t, 1 >, double, double *)> &func, const std::string &when)
	Set delegates for member functions with the signature `void(double, double*)` More...

void	setDelegate (const std::string &name, const std::function< void(std::array< size_t, 2 >, double, double , double )> &func, const std::string &when)
	Set delegates for member functions with the signature `void(double, double, double)` More...

void	setDelegate (const std::string &name, const std::function< void(std::array< size_t, 3 >, double , double , double *)> &func, const std::string &when)
	Set delegates for member functions with the signature `void(double, double, double*)` More...

void	setDelegate (const std::string &name, const std::function< int(std::string &, size_t)> &func, const std::string &when)
	Set delegates for member functions with the signature `string(size_t)` More...

void	setDelegate (const std::string &name, const std::function< int(size_t &, const std::string &)> &func, const std::string &when)
	Set delegates for member functions with the signature `size_t(string)` More...

Protected Member Functions
void	install (const std::string &name, std::function< void()> &target, const std::function< void()> &func)
	Install a function with the signature `void()` as being delegatable. More...

void	install (const std::string &name, std::function< void(bool)> &target, const std::function< void(bool)> &func)
	Install a function with the signature `void(bool)` as being delegatable. More...

void	install (const std::string &name, std::function< void(double)> &target, const std::function< void(double)> &func)
	Install a function with the signature `void(double)` as being delegatable. More...

void	install (const std::string &name, std::function< void(std::array< size_t, 1 >, double )> &target, const std::function< void(std::array< size_t, 1 >, double )> &func)
	Install a function with the signature `void(double*)` as being delegatable. More...

void	install (const std::string &name, std::function< void(std::array< size_t, 1 >, double, double )> &target, const std::function< void(std::array< size_t, 1 >, double, double )> &func)
	Install a function with the signature `void(double, double*)` as being delegatable. More...

void	install (const std::string &name, std::function< void(std::array< size_t, 2 >, double, double , double )> &target, const std::function< void(std::array< size_t, 2 >, double, double , double )> &func)
	Install a function with the signature `void(double, double, double)` as being delegatable. More...

void	install (const std::string &name, std::function< void(std::array< size_t, 3 >, double , double , double )> &target, const std::function< void(std::array< size_t, 3 >, double , double , double )> &base)
	Install a function with the signature `void(double, double, double*)` as being delegatable. More...

void	install (const std::string &name, std::function< std::string(size_t)> &target, const std::function< std::string(size_t)> &base)
	Install a function with the signature `string(size_t)` as being delegatable. More...

void	install (const std::string &name, std::function< size_t(const std::string &)> &target, const std::function< size_t(const std::string &)> &base)
	Install a function with the signature `size_t(string)` as being delegatable. More...

template<typename BaseFunc , class ... Args>
std::function< void(Args ...)>	makeDelegate (const std::function< void(Args ...)> &func, const std::string &when, BaseFunc base)
	Create a delegate for a function with no return value. More...

template<typename ReturnType , class ... Args>
std::function< ReturnType(Args ...)>	makeDelegate (const std::function< int(ReturnType &, Args ...)> &func, const std::string &when, const std::function< ReturnType(Args ...)> &base)
	Create a delegate for a function with a return value. More...

Protected Attributes
Containers for delegates and base class implementations.
Maps named `m_funcs_` hold the current delegate. For functions with a return value, `m_base_` holds a pointer to the base class's implementation of the function. These containers use a naming scheme based on the signature of the corresponding member functions. Following the prefix `_m_funcs_` is a notation of the return type, followed by an underscore, then the notations for each argument, separated by underscores. The following shorthand is used for different return / argument types: `v` for `void` `b` for `bool` `d` for `double` `s` for `std::string` `sz` for `size_t` prefix `c` for `const` arguments suffix `r` for reference arguments suffix `p` for pointer arguments
std::map< std::string, std::function< void()> * >	m_funcs_v

std::map< std::string, std::function< void(bool)> * >	m_funcs_v_b

std::map< std::string, std::function< void(double)> * >	m_funcs_v_d

std::map< std::string, std::function< void(std::array< size_t, 1 >, double )> >	m_funcs_v_dp

std::map< std::string, std::function< void(std::array< size_t, 1 >, double, double )> >	m_funcs_v_d_dp

std::map< std::string, std::function< void(std::array< size_t, 2 >, double, double , double )> * >	m_funcs_v_d_dp_dp

std::map< std::string, std::function< void(std::array< size_t, 3 >, double , double , double )> >	m_funcs_v_dp_dp_dp

std::map< std::string, std::function< std::string(size_t)> >	m_base_s_sz

std::map< std::string, std::function< std::string(size_t)> * >	m_funcs_s_sz

std::map< std::string, std::function< size_t(const std::string &)> >	m_base_sz_csr

std::map< std::string, std::function< size_t(const std::string &)> * >	m_funcs_sz_csr

Detailed Description

Delegate member functions of a C++ class to externally-specified functions.

This base class provides functions for setting delegates for the member functions of a C++ class at runtime. The purpose of this capability is to allow the class to be extended using functions defined in any programming language that provides a C API for calling functions in that language.

Delegates are specified as std::function objects that are responsible for encapsulating the data specific to the target language and calling the appropriate function in the target language. The std::function has a modified function signature compared to the method that it is replacing or augmenting:

Methods with no return value and scalar arguments are treated the same
Methods with a return value have that value as the first reference argument of their delegate function, and return an int. The delegate should return zero if it does not set the arguments value, and a non-zero value if it does.
Methods with pointers to arrays as arguments have an additional argument introduced to indicate the length of each array argument. This argument occurs either first, or after the return value reference, and is a std::array<size_t, N> where N is the number of array arguments.

Delegated methods can be specified to either "replace" the original class's method, or to run "before" or "after" the original method, using the when parameter of the setDelegate method. There are two special cases for delegates of methods with return values:

If the "before" delegate specifies a value for the return parameter (and then returns with a non-zero status value), this value will be returned and the original method will not be called. Otherwise, the original method will be called and its value will be returned.
If an "after" delegate specifies a return value (and returns with a non-zero status value), this value will be added to the value returned by the original method, and this combined result will be then be returned. The meaning of "added" is determined by the + operator for the return type, for example addition for numeric types or concatenation for strings.

Implementation for each delegated function type

Several functions and member variables are defined in this base class for each distinct function signature that can be delegated by a derived class such as ReactorDelegator. These are:

The install function stores the address of a function that will be called by a derived delegator class in the corresponding m_funcs_... map, and sets the default implementation of this method (which should be to call the base class implementation). For delegates with a return type, a copy of this default implementation is also stored in the corresponding m_base_... map
The setDelegate function wraps the user-provided delegate in a function that handles whether the delegate is to be called before, after, or instead of the base class's implementation. This function is then stored at the address specified in the corresponding m_funcs_... map.
m_funcs_... is a mapping between member function names and the addresses of the functions that will be called to implement these functions in the derived delegator class.
m_base_... is a mapping between member function names and the default implementations of these member functions, for delegates with return values

Additional implementation for each function type is specific to the programming language that the delegate is written in. For the Python delegates, see additional documentation in delegator.pyx.

Implementation for specific delegated functions

Beyond the implementation of particular function signatures, there are no elements of the Delegator class that are specific to individual delegated functions, which are handled by derived classes such as ReactorDelegator, which will also inherit from another base class such as Reactor.

Delegation of a member function (for example, Reactor::eval) is handled by several elements:

A std::function member variable to hold a delegate function, or its default implementation. This function type includes the additional std::array argument of array sizes for functions with array arguments.
An override of the member function whose implementation calls the stored delegate. For delegates that need an array of array sizes, this function first calculates the necessary values and passes them as an additional argument to the delegate.
A call to install from the constructor of the derived delegator class, which takes the member function name, a reference to the std::function member variable described above, and a lambda function that implements the default behavior, that is, calling the equivalent base class method.

Additional implementation for each function is specific to the programming language that the delegate is written in. For Python delegates, see additional documentation in delegator.pyx.

Definition at line 100 of file Delegator.h.

Member Function Documentation

◆ setDelegate() [1/9]

void setDelegate	(	const std::string &	name,
		const std::function< void()> &	func,
		const std::string &	when
	)

inline

Set delegates for member functions with the signature void().

Definition at line 104 of file Delegator.h.

References Delegator::makeDelegate().

◆ setDelegate() [2/9]

void setDelegate	(	const std::string &	name,
		const std::function< void(bool)> &	func,
		const std::string &	when
	)

inline

set delegates for member functions with the signature void(bool)

Definition at line 115 of file Delegator.h.

References Delegator::makeDelegate().

◆ setDelegate() [3/9]

void setDelegate	(	const std::string &	name,
		const std::function< void(double)> &	func,
		const std::string &	when
	)

inline

set delegates for member functions with the signature void(double)

Definition at line 126 of file Delegator.h.

References Delegator::makeDelegate().

◆ setDelegate() [4/9]

void setDelegate	(	const std::string &	name,
		const std::function< void(std::array< size_t, 1 >, double *)> &	func,
		const std::string &	when
	)

inline

Set delegates for member functions with the signature void(double*)

Definition at line 137 of file Delegator.h.

References Delegator::makeDelegate().

◆ setDelegate() [5/9]

void setDelegate	(	const std::string &	name,
		const std::function< void(std::array< size_t, 1 >, double, double *)> &	func,
		const std::string &	when
	)

inline

Set delegates for member functions with the signature void(double, double*)

Definition at line 149 of file Delegator.h.

References Delegator::makeDelegate().

◆ setDelegate() [6/9]

void setDelegate	(	const std::string &	name,
		const std::function< void(std::array< size_t, 2 >, double, double , double )> &	func,
		const std::string &	when
	)

inline

Set delegates for member functions with the signature void(double, double*, double*)

Definition at line 164 of file Delegator.h.

References Delegator::makeDelegate().

◆ setDelegate() [7/9]

void setDelegate	(	const std::string &	name,
		const std::function< void(std::array< size_t, 3 >, double , double , double *)> &	func,
		const std::string &	when
	)

inline

Set delegates for member functions with the signature void(double*, double*, double*)

Definition at line 179 of file Delegator.h.

References Delegator::makeDelegate().

◆ setDelegate() [8/9]

void setDelegate	(	const std::string &	name,
		const std::function< int(std::string &, size_t)> &	func,
		const std::string &	when
	)

inline

Set delegates for member functions with the signature string(size_t)

Definition at line 193 of file Delegator.h.

References Delegator::makeDelegate().

◆ setDelegate() [9/9]

void setDelegate	(	const std::string &	name,
		const std::function< int(size_t &, const std::string &)> &	func,
		const std::string &	when
	)

inline

Set delegates for member functions with the signature size_t(string)

Definition at line 206 of file Delegator.h.

References Delegator::makeDelegate().

◆ install() [1/9]

void install	(	const std::string &	name,
		std::function< void()> &	target,
		const std::function< void()> &	func
	)

inlineprotected

Install a function with the signature void() as being delegatable.

Definition at line 220 of file Delegator.h.

◆ install() [2/9]

void install	(	const std::string &	name,
		std::function< void(bool)> &	target,
		const std::function< void(bool)> &	func
	)

inlineprotected

Install a function with the signature void(bool) as being delegatable.

Definition at line 228 of file Delegator.h.

◆ install() [3/9]

void install	(	const std::string &	name,
		std::function< void(double)> &	target,
		const std::function< void(double)> &	func
	)

inlineprotected

Install a function with the signature void(double) as being delegatable.

Definition at line 236 of file Delegator.h.

◆ install() [4/9]

void install	(	const std::string &	name,
		std::function< void(std::array< size_t, 1 >, double *)> &	target,
		const std::function< void(std::array< size_t, 1 >, double *)> &	func
	)

inlineprotected

Install a function with the signature void(double*) as being delegatable.

Definition at line 244 of file Delegator.h.

◆ install() [5/9]

void install	(	const std::string &	name,
		std::function< void(std::array< size_t, 1 >, double, double *)> &	target,
		const std::function< void(std::array< size_t, 1 >, double, double *)> &	func
	)

inlineprotected

Install a function with the signature void(double, double*) as being delegatable.

Definition at line 253 of file Delegator.h.

◆ install() [6/9]

void install	(	const std::string &	name,
		std::function< void(std::array< size_t, 2 >, double, double , double )> &	target,
		const std::function< void(std::array< size_t, 2 >, double, double , double )> &	func
	)

inlineprotected

Install a function with the signature void(double, double*, double*) as being delegatable.

Definition at line 263 of file Delegator.h.

◆ install() [7/9]

void install	(	const std::string &	name,
		std::function< void(std::array< size_t, 3 >, double , double , double *)> &	target,
		const std::function< void(std::array< size_t, 3 >, double , double , double *)> &	base
	)

inlineprotected

Install a function with the signature void(double*, double*, double*) as being delegatable.

Definition at line 273 of file Delegator.h.

◆ install() [8/9]

void install	(	const std::string &	name,
		std::function< std::string(size_t)> &	target,
		const std::function< std::string(size_t)> &	base
	)

inlineprotected

Install a function with the signature string(size_t) as being delegatable.

Definition at line 282 of file Delegator.h.

◆ install() [9/9]

void install	(	const std::string &	name,
		std::function< size_t(const std::string &)> &	target,
		const std::function< size_t(const std::string &)> &	base
	)

inlineprotected

Install a function with the signature size_t(string) as being delegatable.

Definition at line 292 of file Delegator.h.

◆ makeDelegate() [1/2]

std::function< void(Args ...)> makeDelegate	(	const std::function< void(Args ...)> &	func,
		const std::string &	when,
		BaseFunc	base
	)

inlineprotected

Create a delegate for a function with no return value.

Definition at line 303 of file Delegator.h.

Referenced by Delegator::setDelegate().

◆ makeDelegate() [2/2]

std::function< ReturnType(Args ...)> makeDelegate	(	const std::function< int(ReturnType &, Args ...)> &	func,
		const std::string &	when,
		const std::function< ReturnType(Args ...)> &	base
	)

inlineprotected

Create a delegate for a function with a return value.

Definition at line 331 of file Delegator.h.

References Cantera::demangle().

Member Data Documentation

◆ m_funcs_v

std::map<std::string, std::function<void()>*> m_funcs_v

protected

Definition at line 403 of file Delegator.h.

◆ m_funcs_v_b

std::map<std::string, std::function<void(bool)>*> m_funcs_v_b

protected

Definition at line 404 of file Delegator.h.

◆ m_funcs_v_d

std::map<std::string, std::function<void(double)>*> m_funcs_v_d

protected

Definition at line 405 of file Delegator.h.

◆ m_funcs_v_dp

std::map<std::string, std::function<void(std::array<size_t, 1>, double*)>*> m_funcs_v_dp

protected

Definition at line 407 of file Delegator.h.

◆ m_funcs_v_d_dp

std::map<std::string, std::function<void(std::array<size_t, 1>, double, double*)>*> m_funcs_v_d_dp

protected

Definition at line 409 of file Delegator.h.

◆ m_funcs_v_d_dp_dp

std::map<std::string, std::function<void(std::array<size_t, 2>, double, double*, double*)>*> m_funcs_v_d_dp_dp

protected

Definition at line 411 of file Delegator.h.

◆ m_funcs_v_dp_dp_dp

std::map<std::string, std::function<void(std::array<size_t, 3>, double*, double*, double*)>*> m_funcs_v_dp_dp_dp

protected

Definition at line 413 of file Delegator.h.

◆ m_base_s_sz

std::map<std::string, std::function<std::string(size_t)> > m_base_s_sz

protected

Definition at line 417 of file Delegator.h.

◆ m_funcs_s_sz

std::map<std::string, std::function<std::string(size_t)>*> m_funcs_s_sz

protected

Definition at line 419 of file Delegator.h.

◆ m_base_sz_csr

std::map<std::string, std::function<size_t(const std::string&)> > m_base_sz_csr

protected

Definition at line 422 of file Delegator.h.

◆ m_funcs_sz_csr

std::map<std::string, std::function<size_t(const std::string&)>*> m_funcs_sz_csr

protected

Definition at line 424 of file Delegator.h.

The documentation for this class was generated from the following file:

Delegator.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Implementation for each delegated function type

Implementation for specific delegated functions

Member Function Documentation

◆ setDelegate() [1/9]

◆ setDelegate() [2/9]

◆ setDelegate() [3/9]

◆ setDelegate() [4/9]

◆ setDelegate() [5/9]

◆ setDelegate() [6/9]

◆ setDelegate() [7/9]

◆ setDelegate() [8/9]

◆ setDelegate() [9/9]

◆ install() [1/9]

◆ install() [2/9]

◆ install() [3/9]

◆ install() [4/9]

◆ install() [5/9]

◆ install() [6/9]

◆ install() [7/9]

◆ install() [8/9]

◆ install() [9/9]

◆ makeDelegate() [1/2]

◆ makeDelegate() [2/2]

Member Data Documentation

◆ m_funcs_v

◆ m_funcs_v_b

◆ m_funcs_v_d

◆ m_funcs_v_dp

◆ m_funcs_v_d_dp

◆ m_funcs_v_d_dp_dp

◆ m_funcs_v_dp_dp_dp

◆ m_base_s_sz

◆ m_funcs_s_sz

◆ m_base_sz_csr

◆ m_funcs_sz_csr