definition of the mapping namespace More...

Namespaces
namespace	oo
	definition of the dd namespace for mapping

namespace	rt
	definition of the rt namespace for mapping

Classes
class	ArraySourceValue
	Source Value base class that represents an array. More...

class	AssignmentTrigger
	Trigger interface to trigger the assignments of a specific target. More...

class	AssignmentTriggerSourceTime
	Trigger interface to trigger the assignments of a specific target together with a update time strategy. More...

class	ConstantValueFactory
	Constant value factory to create a constant numeric value of `value`. More...

class	DDLEnumTableFunction
	Enum Table function with type string "ddl_enum_table". The callable function retrieved with getCallable() will transform the given value to another mapped value. More...

class	DDLSource
	DDLSource implementation class representing a MemorySource that provides named source values for ddl based decoding. More...

class	DDLTarget
	DDLTarget implementation class representing a MemoryTarget that provides named target values for ddl based encoding. More...

class	DefaultEngine
	Default engine implementation. More...

class	Engine
	Mapping engine base class. More...

class	Function
	Mapping Function base class. More...

class	FunctionFactoryImplementation
	FunctionFactory implementation template. More...

class	InlinePolynomialFunction
	Inline Polynomial function with type string "inline_polynomial". The callable function retrieved with getCallable() will transform the value with result = (a * value^0 + b * value^1 + c * value^2 + d * value^3 + d * value^4 + e * value^5) where parameters are value, a, b, c, d, e. More...

class	MapAssignment

class	MapConfiguration

class	MapDataTrigger
	implementation of a data trigger in the configuration api More...

class	MapEnumTableTransformation
	MapEnumTableTransformation represents a transformation between to enumerations. More...

class	MapHeader

class	Mapper
	The mapper to create the targets from sources. More...

class	MapperElement
	Mapper Element. More...

class	MapperElementBase
	Mapper Element base template. More...

class	MapperFactories
	Mapping factory collection class registry. More...

class	MapperFactory
	A mapper factory to create Source, Target or Function. More...

class	MapPeriodicTrigger
	implementation of a periodic trigger in the configuration api More...

class	MappingConfiguration
	Mapping Configuration model with validation and requirements management. More...

struct	MappingConfigurationFromXMLFactory
	Factory to create a MappingConfiguration out of a XML based description. This factory uses a template type DomNodeType which is design to follow the a concept class type definition of the a_util::DOMElement. More...

struct	MappingConfigurationFromXMLFactory10
	Factory to create a MappingConfiguration out of a XML based description. This factory uses a template type `DomNodeType` which is designed to follow the a concept class type definition of the a_util::DOMElement. More...

struct	MappingConfigurationFromXMLFactoryBase
	Factory helper to create a MappingConfiguration out of a XML based description. This factory uses a template type DomNodeType which is design to follow the a concept class type definition of the a_util::DOMElement. More...

struct	MappingConfigurationToXMLFactory
	Template class to create MappingConfiguration DOM nodes with the help of the type DomNodeType. More...

struct	MappingConfigurationToXMLFactory10
	Template class to create MappingConfiguration DOM nodes with the help of the type DomNodeType. More...

struct	MappingConfigurationToXMLFactoryBase
	Template class to create MappingConfiguration DOM nodes with the help of the type DomNodeType. More...

class	MappingFile
	Convenience class to load and validate a MappingConfiguration from a xml file string. This implementation can be used as follows: More...

class	MappingString
	Convenience class to load and validate a MappingConfiguration from a xml string. This implementation can be used as follows: More...

class	MapPolynomTransformation

class	MapSignalTrigger
	implementation of a signal trigger in the configuration api More...

class	MapSource

class	MapTarget

class	MapTransformationBase

class	MapTriggerBase

class	Memory
	Memory base class for sources and targets representing a continous memory buffer. More...

class	MemorySource
	Source memory base class for sources representing a continuous memory buffer. More...

class	MemoryTarget
	Memory Target base class that represents a continuous memory buffer. More...

class	PlainSourceValue
	Value getter to retrieve a value with plain type content. More...

class	PolynomialFunction
	Polynomial function with type string "polynomial". The callable function retrieved with getCallable() will transform the value with result = (a * value^0 + b * value^1 + c * value^2 + d * value^3 + d * value^4 + e * value^5) Properties: More...

class	Property
	Property class representing a pair of value and its type. More...

class	SimulationTimeFunction
	Simulation time function to retrieve the last known simulation time updated by time trigger. Properties: More...

class	SimulationTimeFunctionFactory
	Factory for SimulationTimeFunction as type "simulation_time". More...

class	Source
	Mapping Source base class. More...

class	SourceFactoryImplementation
	SourceFactory implementation template. More...

class	SourceValue
	Source Value base class. More...

class	SpecificMapperFactory
	A specific mapper factory to create Source, Target or Function. More...

class	Target
	Mapping Target base class. More...

class	TargetFactoryImplementation
	TargetFactory implementation template. More...

class	TargetValue
	Value setter to set a value. More...

class	TimeStrategy

class	TriggerCounterFunction
	Trigger counter function to retrieve the current count of a certain trigger fired. The retrieved callable returns the amount of triggers on the target or source with `name`. More...

class	Updateable
	Updateable interface class. More...

class	Version
	Mapping Version. More...

class	WasReceivedFunction
	Was received function to retrieve if at least the given source with `name` was received. The callable will return a bool value. More...

Typedefs
typedef std::vector< std::string >	MapErrorList
	container type for mapping errors

typedef std::vector< MapAssignment >	MapAssignmentList
	Public composite types used in the mapping::dd namespace.

typedef std::vector< MapSource >	MapSourceList
	Public composite types used in the mapping::dd namespace.

typedef std::set< std::string >	MapSourceNameList
	defintion of MapSource name list

typedef std::vector< MapTarget >	MapTargetList
	Public composite types used in the mapping::dd namespace.

typedef std::vector< MapTransformationBase * >	MapTransformationList
	Public composite types used in the mapping::dd namespace.

typedef std::vector< MapTriggerBase * >	MapTriggerList
	Public composite types used in the mapping::dd namespace.

typedef std::map< std::string, uint8_t >	TypeMap
	String -> Datatype Enum Map.

using	ValueVariant
	Variant Value to retrieve a plain type value of a source.

using	Properties = std::unordered_map<std::string, Property>
	Properties class as set of key - property value pairs This proerties are used to adjust the readers and propcessors behaviour.

using	SourceFactory = SpecificMapperFactory<Source>
	A Source factory to create a Source.

using	TargetFactory = SpecificMapperFactory<Target>
	A Target factory to create a Target.

using	FunctionFactory = SpecificMapperFactory<Function>
	A Function factory to create a Function.

using	Error = ddl::utility::Error
	mapping error definition

using	Problem = ddl::utility::Problem
	defintion of problems for validation of the MappingConfiguration

using	Requirement = ddl::utility::VersionRequirement<Version>
	mapping version requirements

using	VersionConversion = ddl::dd::VersionConversion
	Resuse of ddl Version conversion utility class for mapping version.

Enumerations
enum	DataTypes { e_uint8 = 1 , e_uint16 , e_uint32 , e_uint64 , e_int8 , e_int16 , e_int32 , e_int64 , e_float32 , e_float64 , e_bool , e_char }
	Enum for all relevant data types.

enum class	ValidationLevel : uint8_t { dont_know , invalid , good_enough , valid }
	MappingConfiguration validation level. More...

Functions
std::string	getMapping10FunctionCallAttributes (const datamodel::Assignment &assignment, const std::string &current_target_name, const datamodel::MappingConfiguration::Functions &functions, std::vector< std::pair< std::string, std::string > > &attributes_to_set)
	Get the Mapping10 Module Call Attributes.

bool	operator== (const MapAssignment &a, const MapAssignment &b)
	compares the Assignments

bool	operator!= (const MapAssignment &a, const MapAssignment &b)
	compares the Assignments

bool	operator== (const MapSource &a, const MapSource &b)
	compares MapSources in type and name

bool	operator!= (const MapSource &a, const MapSource &b)
	compares MapSources in type and name

bool	operator== (const MapTarget &a, const MapTarget &b)
	compares the targets

bool	operator!= (const MapTarget &a, const MapTarget &b)
	compares the targets

template<typename T>
void	getValueRef (const ValueVariant &value, T &value_reference)
	Get the value from a variant as plain type T.

template<typename T>
T	getValue (const ValueVariant &value)
	Get the value.

bool	operator== (const Property &left, const Property &right)
	compare operator for Property

Properties	operator+ (const Properties &properties_left, const Properties &properties_right)
	Add operator for properties.

std::vector< std::string >	transformValidationProblemList (const std::vector< Problem > &problems)
	transforms the validation protocol of problems to a simple vector of strings. Simple usage:

MapperFactories	getDefaultMapperFactories ()
	Retrieves the default mapper factories This contains:

Detailed Description

definition of the mapping namespace

Typedef Documentation

◆ ValueVariant

using ddl::mapping::ValueVariant

Initial value:

 std::variant<uint8_t,
                                  int8_t,
                                  uint16_t,
                                  int16_t,
                                  uint32_t,
                                  int32_t,
                                  uint64_t,
                                  int64_t,
                                  float,
                                  double,
                                  bool>

Variant Value to retrieve a plain type value of a source.

Enumeration Type Documentation

◆ ValidationLevel

enum class ddl::mapping::ValidationLevel : uint8_t

strong

MappingConfiguration validation level.

Enumerator
dont_know	The validation is not known. This means there was no validation.
invalid	the validation level is invalid.
good_enough	the mapping is valid for running at engine, but has problems
valid	every thing is well defined.

Function Documentation

◆ getDefaultMapperFactories()

MapperFactories ddl::mapping::getDefaultMapperFactories ( )

Retrieves the default mapper factories This contains:

sources: "ddl" (DDLSource)
targets: "ddl" (DDLTarget)
functions: "inline_polynomial" (InlinePolynomialFunction), "trigger_counter" (TriggerCounterFunction), "was_received" (WasReceivedFunction), "polynomial" (PolynomialFunction), "ddl_enum_table" (DDLEnumTableFunction)
Returns
MapperFactories

◆ getMapping10FunctionCallAttributes()

std::string ddl::mapping::getMapping10FunctionCallAttributes	(	const datamodel::Assignment &	assignment,
		const std::string &	current_target_name,
		const datamodel::MappingConfiguration::Functions &	functions,
		std::vector< std::pair< std::string, std::string > > &	attributes_to_set )

inline

Get the Mapping10 Module Call Attributes.

Remarks: this is a DOM independent function to reuse within requirements model of the MappingConfiguration!

Parameters

assignment	the assignemnt to serialize
current_target_name	the current target the assignment belongs to
functions	the "functions" node
attributes_to_set	the resulting attributes to set

Returns: std::string error message return value, if empty no error occured

◆ getValue()

template<typename T>

T ddl::mapping::getValue ( const ValueVariant & value )

Get the value.

Template Parameters

T	The type to convert the value to

Returns: T The value retrieved

◆ getValueRef()

template<typename T>

void ddl::mapping::getValueRef	(	const ValueVariant &	value,
		T &	value_reference )

Get the value from a variant as plain type T.

Template Parameters

T	the type of the value to retrieve and convert

Parameters

value	the variant value
value_reference	the value reference to retrieve and convert to

◆ operator!=() [1/3]

bool ddl::mapping::operator!=	(	const MapAssignment &	a,
		const MapAssignment &	b )

inline

compares the Assignments

Parameters

a	left Assignments
b	right Assignments

Returns: false the Assignments are equal; true the Assignments are not equal

◆ operator!=() [2/3]

bool ddl::mapping::operator!=	(	const MapSource &	a,
		const MapSource &	b )

inline

compares MapSources in type and name

Parameters

a	left source
b	right source

Returns: false they are equal in type and name; true they are not equal in type and name

◆ operator!=() [3/3]

bool ddl::mapping::operator!=	(	const MapTarget &	a,
		const MapTarget &	b )

inline

compares the targets

Parameters

a	left target
b	right target

Returns: false the targets are equal; true the targets are not equal

◆ operator+()

Properties ddl::mapping::operator+	(	const Properties &	properties_left,
		const Properties &	properties_right )

inline

Add operator for properties.

Parameters

properties_left	the left properties
properties_right	the right properties to add

Returns: Properties

Remarks: if right properties are containing a value with the same key as left it will take the right one into concern

◆ operator==() [1/4]

bool ddl::mapping::operator==	(	const MapAssignment &	a,
		const MapAssignment &	b )

inline

compares the Assignments

Parameters

a	left Assignments
b	right Assignments

Returns: true the Assignments are equal; false the Assignments are not equal

◆ operator==() [2/4]

bool ddl::mapping::operator==	(	const MapSource &	a,
		const MapSource &	b )

inline

compares MapSources in type and name

Parameters

a	left source
b	right source

Returns: true they are equal in type and name; false they are not equal in type and name

◆ operator==() [3/4]

bool ddl::mapping::operator==	(	const MapTarget &	a,
		const MapTarget &	b )

compares the targets

Parameters

a	left target
b	right target

Returns: true the targets are equal; false the targets are not equal

◆ operator==() [4/4]

bool ddl::mapping::operator==	(	const Property &	left,
		const Property &	right )

inline

compare operator for Property

Parameters

left	the left value
right	the right value

Returns: true is equal in type and value; false is not equal in type or value

◆ transformValidationProblemList()

std::vector< std::string > ddl::mapping::transformValidationProblemList ( const std::vector< Problem > & problems )

transforms the validation protocol of problems to a simple vector of strings.
Simple usage:

//...
 
using namespace ddl;
mapping::MappingConfiguration my_config;
//... adding ... loading ... using
std::cout <<
a_util::strings::join(mapping::transformValidationProblemList(my_config.getValidationProtocol()),"\n");

Parameters

problems the problems to tranform.

Returns: std::vector<std::string>

Namespaces

Classes

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

◆ ValueVariant

Enumeration Type Documentation

◆ ValidationLevel

Function Documentation

◆ getDefaultMapperFactories()

◆ getMapping10FunctionCallAttributes()

◆ getValue()

◆ getValueRef()

◆ operator!=() [1/3]

◆ operator!=() [2/3]

◆ operator!=() [3/3]

◆ operator+()

◆ operator==() [1/4]

◆ operator==() [2/4]

◆ operator==() [3/4]

◆ operator==() [4/4]

◆ transformValidationProblemList()