Detailed Description

The interface to access parameter values identified by name and/or (semantic) type.

Definition at line 51 of file ParameterProvider.hpp.

Inheritance diagram for dw::framework::ParameterProvider:

Public Member Functions
template<typename S , typename T , size_t N, std::enable_if_t< std::is_same< T, dw::core::FixedString< N > >::value > * = nullptr>
bool	get (dw::core::StringView const &key, dw::core::FixedString< N > *out) const

template<typename S , typename T , size_t N, std::enable_if_t< std::is_same< T, dw::core::FixedString< N > >::value > * = nullptr>
bool	get (dw::core::StringView const &key, size_t const index, dw::core::FixedString< N > *out) const

template<typename T , typename std::enable_if_t< !std::is_array< T >::value &&!std::is_enum< T >::value > * = nullptr>
bool	get (dw::core::StringView const &key, size_t const index, T *out) const

template<typename S , typename T , std::enable_if_t<!std::is_enum< T >::value > * = nullptr>
bool	get (dw::core::StringView const &key, size_t const index, T *out) const

template<typename S , typename T , std::enable_if_t< std::is_enum< T >::value > * = nullptr>
bool	get (dw::core::StringView const &key, size_t const index, T *out) const

template<typename T , typename std::enable_if_t< !std::is_array< T >::value &&!std::is_enum< T >::value > * = nullptr>
bool	get (dw::core::StringView const &key, std::vector< T > *out) const

template<typename T , typename std::enable_if_t< !std::is_array< T >::value &&!std::is_enum< T >::value > * = nullptr>
bool	get (dw::core::StringView const &key, T *out) const

template<typename T , typename std::enable_if_t< std::is_array< T >::value &&std::rank< T >::value==1 &&!std::is_enum< std::remove_extent_t< T > >::value > * = nullptr>
bool	get (dw::core::StringView const &key, T *out) const

template<typename T , typename std::enable_if_t< std::is_array< T >::value &&std::rank< T >::value==1 &&std::is_same< T, char8_t >::value > * = nullptr>
bool	get (dw::core::StringView const &key, T *out) const

template<typename T , typename std::enable_if_t< std::is_array< T >::value &&std::rank< T >::value==2 &&!std::is_enum< std::remove_all_extents_t< T > >::value > * = nullptr>
bool	get (dw::core::StringView const &key, T *out) const

template<typename S , typename T , std::enable_if_t<!std::is_enum< T >::value > * = nullptr>
bool	get (dw::core::StringView const &key, T *out) const

template<typename S , typename T , std::enable_if_t< std::is_enum< T >::value > * = nullptr>
bool	get (dw::core::StringView const &key, T *out) const

virtual bool	get (ParameterProvider const const parentProvider, dw::core::StringView const &key, const std::type_info &semanticTypeInfo, const std::type_info &dataTypeInfo, void out) const =0

virtual bool	get (ParameterProvider const const parentProvider, dw::core::StringView const &key, size_t const index, const std::type_info &semanticTypeInfo, const std::type_info &dataTypeInfo, void out) const =0

template<typename T >
bool	getOptional (dw::core::StringView const &key, size_t const index, T *out) const

template<typename S , typename T >
bool	getOptional (dw::core::StringView const &key, size_t const index, T *out) const

template<typename T >
bool	getOptional (dw::core::StringView const &key, T *out) const

template<typename S , typename T >
bool	getOptional (dw::core::StringView const &key, T *out) const

template<typename T >
void	getRequired (dw::core::StringView const &key, size_t const index, T *out) const

template<typename S , typename T >
void	getRequired (dw::core::StringView const &key, size_t const index, T *out) const

template<typename T >
void	getRequired (dw::core::StringView const &key, T *out) const

template<typename S , typename T >
void	getRequired (dw::core::StringView const &key, T *out) const

	ParameterProvider ()=default
	Default constructor. More...

virtual	~ParameterProvider ()=default
	Destructor. More...

Protected Member Functions
ParameterProvider &	operator= (ParameterProvider &&) &=default
	Move assignment operator. More...

ParameterProvider &	operator= (ParameterProvider const &) &=default
	Copy assignment operator. More...

	ParameterProvider (ParameterProvider &&)=default
	Move constructor. More...

	ParameterProvider (ParameterProvider const &)=default
	Copy constructor. More...

Constructor & Destructor Documentation

◆ ParameterProvider() [1/3]

dw::framework::ParameterProvider::ParameterProvider ( ParameterProvider const & )

protecteddefault

Copy constructor.

◆ ParameterProvider() [2/3]

dw::framework::ParameterProvider::ParameterProvider ( ParameterProvider && )

protecteddefault

Move constructor.

◆ ParameterProvider() [3/3]

dw::framework::ParameterProvider::ParameterProvider ( )

default

Default constructor.

◆ ~ParameterProvider()

virtual dw::framework::ParameterProvider::~ParameterProvider ( )

virtualdefault

Destructor.

Member Function Documentation

◆ get() [1/14]

template<typename S , typename T , size_t N, std::enable_if_t< std::is_same< T, dw::core::FixedString< N > >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		dw::core::FixedString< N > *	out
	)		const

inline

Get a FixedString parameter value with a semantic type.

See also: get(ParameterProvider const* const, dw::core::StringView const&, const std::type_info&, const std::type_info&, T*)

Definition at line 406 of file ParameterProvider.hpp.

References get().

◆ get() [2/14]

template<typename S , typename T , size_t N, std::enable_if_t< std::is_same< T, dw::core::FixedString< N > >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		size_t const	index,
		dw::core::FixedString< N > *	out
	)		const

inline

Get a FixedString parameter value with a semantic type from an array parameter by index.

See also: get(ParameterProvider const* const, dw::core::StringView const&, size_t const, const std::type_info&, const std::type_info&, T*)

Definition at line 482 of file ParameterProvider.hpp.

References get().

◆ get() [3/14]

template<typename T , typename std::enable_if_t< !std::is_array< T >::value &&!std::is_enum< T >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		size_t const	index,
		T *	out
	)		const

inline

Get a single non-enum parameter value from an array parameter by index.

See also: get(ParameterProvider const* const, dw::core::StringView const&, const std::type_info&, const std::type_info&, size_t const, T*)

Definition at line 164 of file ParameterProvider.hpp.

References get().

◆ get() [4/14]

template<typename S , typename T , std::enable_if_t<!std::is_enum< T >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		size_t const	index,
		T *	out
	)		const

inline

Get a non-enum parameter value with a semantic type from an array parameter by index.

See also: get(ParameterProvider const* const, dw::core::StringView const&, size_t const, const std::type_info&, const std::type_info&, T*)

Definition at line 467 of file ParameterProvider.hpp.

References get().

◆ get() [5/14]

template<typename S , typename T , std::enable_if_t< std::is_enum< T >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		size_t const	index,
		T *	out
	)		const

inline

Get an enum parameter value with a semantic type from an array parameter by index.

The parameter value retrieved is of type string and is being mapped to the enum type output parameter.

See also: get(ParameterProvider const* const, dw::core::StringView const&, size_t const, const std::type_info&, const std::type_info&, T*)

Definition at line 510 of file ParameterProvider.hpp.

References get().

◆ get() [6/14]

template<typename T , typename std::enable_if_t< !std::is_array< T >::value &&!std::is_enum< T >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		std::vector< T > *	out
	)		const

inline

Get a vector of non-enum parameter values.

See also: get(ParameterProvider const* const, dw::core::StringView const&, const std::type_info&, const std::type_info&, T*)

Definition at line 180 of file ParameterProvider.hpp.

References get().

◆ get() [7/14]

template<typename T , typename std::enable_if_t< !std::is_array< T >::value &&!std::is_enum< T >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Get a non-array non-enum parameter value.

See also: get(ParameterProvider const* const, dw::core::StringView const&, const std::type_info&, const std::type_info&, T*)

Definition at line 148 of file ParameterProvider.hpp.

References get().

Referenced by get(), and getOptional().

◆ get() [8/14]

template<typename T , typename std::enable_if_t< std::is_array< T >::value &&std::rank< T >::value==1 &&!std::is_enum< std::remove_extent_t< T > >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Get a fixed-size 1 dimension array of non-enum parameter values.

See also: get(ParameterProvider const* const, std::vector<T>*)

Definition at line 197 of file ParameterProvider.hpp.

References get().

◆ get() [9/14]

template<typename T , typename std::enable_if_t< std::is_array< T >::value &&std::rank< T >::value==1 &&std::is_same< T, char8_t >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Get a fixed-size 1 dimension array of non-enum parameter values of type char8_t.

See also: get(ParameterProvider const* const, std::vector<T>*)

Definition at line 235 of file ParameterProvider.hpp.

References get().

◆ get() [10/14]

template<typename T , typename std::enable_if_t< std::is_array< T >::value &&std::rank< T >::value==2 &&!std::is_enum< std::remove_all_extents_t< T > >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Get a fixed-size 2 dimension array of non-enum parameter values.

See also: get(ParameterProvider const* const, std::vector<T>*)

Definition at line 265 of file ParameterProvider.hpp.

References get().

◆ get() [11/14]

template<typename S , typename T , std::enable_if_t<!std::is_enum< T >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Get a non-enum parameter value with a semantic type.

See also: get(ParameterProvider const* const, dw::core::StringView const&, const std::type_info&, const std::type_info&, T*)

Definition at line 383 of file ParameterProvider.hpp.

References get().

◆ get() [12/14]

template<typename S , typename T , std::enable_if_t< std::is_enum< T >::value > * = nullptr>

bool dw::framework::ParameterProvider::get	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Get an enum parameter value with a semantic type.

The parameter value retrieved is of type string and is being mapped to the enum type output parameter.

See also: get(ParameterProvider const* const, dw::core::StringView const&, const std::type_info&, const std::type_info&, T*)

Definition at line 434 of file ParameterProvider.hpp.

References get().

◆ get() [13/14]

virtual bool dw::framework::ParameterProvider::get	(	ParameterProvider const *const	parentProvider,
		dw::core::StringView const &	key,
		const std::type_info &	semanticTypeInfo,
		const std::type_info &	dataTypeInfo,
		void *	out
	)		const

pure virtual

Get a parameter.

Parameters

[in]	parentProvider	The parent provider in case the lookup goes through a hierarchy of providers, otherwise nullptr
[in]	key	The parameter name, or an empty string if the (semantic) type sufficiently identifies the parameter
[in]	semanticTypeInfo	The semantic type info of the parameter, which can be different from the data type info to handle parameters with the same data type differently
[in]	dataTypeInfo	The type info of the parameter value
[out]	out	The parameter value is returned here if true is returned

Returns: true if the requested parameter value was set in the out parameter, false if the requested parameter isn't available

Exceptions

if	the requested parameter failed to be retrieved

Implemented in dw::framework::TypeBasedParameterProvider.

◆ get() [14/14]

virtual bool dw::framework::ParameterProvider::get	(	ParameterProvider const *const	parentProvider,
		dw::core::StringView const &	key,
		size_t const	index,
		const std::type_info &	semanticTypeInfo,
		const std::type_info &	dataTypeInfo,
		void *	out
	)		const

pure virtual

Get a parameter value from an array parameter by index.

Parameters

[in]	parentProvider	The parent provider in case the lookup goes through a hierarchy of providers, otherwise nullptr
[in]	key	The parameter name, or an empty string if the (semantic) type sufficiently identifies the parameter
[in]	index	The index of the value in the array parameter
[in]	semanticTypeInfo	The semantic type info of the parameter, which can be different from the data type info to handle parameters with the same data type differently
[in]	dataTypeInfo	The type info of the parameter value
[out]	out	The parameter value is returned here if true is returned

Returns: true if the requested parameter value was set in the out parameter, false if the requested parameter isn't available

Exceptions

if	the requested parameter failed to be retrieved

Implemented in dw::framework::TypeBasedParameterProvider.

◆ getOptional() [1/4]

template<typename T >

bool dw::framework::ParameterProvider::getOptional	(	dw::core::StringView const &	key,
		size_t const	index,
		T *	out
	)		const

inline

Convenience API throwing an exception instead of returning a failed status.

See also: get(dw::core::StringView const&, size_t const, T*)

Exceptions

Exception if the parameter retrieval has a failure

Definition at line 125 of file ParameterProvider.hpp.

References get().

◆ getOptional() [2/4]

template<typename S , typename T >

bool dw::framework::ParameterProvider::getOptional	(	dw::core::StringView const &	key,
		size_t const	index,
		T *	out
	)		const

inline

Convenience API throwing an exception instead of returning a failed status.

See also: get(dw::core::StringView const&, size_t const, T*)

Exceptions

Exception if the parameter retrieval has a failure

Definition at line 354 of file ParameterProvider.hpp.

◆ getOptional() [3/4]

template<typename T >

bool dw::framework::ParameterProvider::getOptional	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Convenience API throwing an exception instead of returning a failed status.

See also: get(dw::core::StringView const&, T*)

Exceptions

Exception if the parameter retrieval has a failure

Definition at line 106 of file ParameterProvider.hpp.

References get().

Referenced by getRequired().

◆ getOptional() [4/4]

template<typename S , typename T >

bool dw::framework::ParameterProvider::getOptional	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Convenience API throwing an exception instead of returning a failed status.

See also: get(dw::core::StringView const&, T*)

Exceptions

Exception if the parameter retrieval has a failure

Definition at line 327 of file ParameterProvider.hpp.

◆ getRequired() [1/4]

template<typename T >

void dw::framework::ParameterProvider::getRequired	(	dw::core::StringView const &	key,
		size_t const	index,
		T *	out
	)		const

inline

Convenience API throwing an exception instead of returning false.

See also: getOptional(dw::core::StringView const&, size_t const, T*)

Exceptions

Exception if the parameter is not successfully retrieved

Definition at line 91 of file ParameterProvider.hpp.

References getOptional().

◆ getRequired() [2/4]

template<typename S , typename T >

void dw::framework::ParameterProvider::getRequired	(	dw::core::StringView const &	key,
		size_t const	index,
		T *	out
	)		const

inline

Convenience API throwing an exception instead of returning false.

See also: getOptional(dw::core::StringView const&, size_t const, T*)

Exceptions

Exception if the parameter is not successfully retrieved

Definition at line 312 of file ParameterProvider.hpp.

◆ getRequired() [3/4]

template<typename T >

void dw::framework::ParameterProvider::getRequired	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Convenience API throwing an exception instead of returning false.

See also: getOptional(dw::core::StringView const&, T*)

Exceptions

Exception if the parameter is not successfully retrieved

Definition at line 76 of file ParameterProvider.hpp.

References getOptional().

◆ getRequired() [4/4]

template<typename S , typename T >

void dw::framework::ParameterProvider::getRequired	(	dw::core::StringView const &	key,
		T *	out
	)		const

inline

Convenience API throwing an exception instead of returning false.

See also: getOptional(dw::core::StringView const&, T*)

Exceptions

Exception if the parameter is not successfully retrieved

Definition at line 297 of file ParameterProvider.hpp.

◆ operator=() [1/2]

ParameterProvider & dw::framework::ParameterProvider::operator= ( ParameterProvider && ) &

protecteddefault

Move assignment operator.

◆ operator=() [2/2]

ParameterProvider & dw::framework::ParameterProvider::operator= ( ParameterProvider const & ) &

protecteddefault

Copy assignment operator.

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

src/dwcgf/core/dwcgf/parameter/ParameterProvider.hpp

Detailed Description

Public Member Functions

Protected Member Functions

Constructor & Destructor Documentation

◆ ParameterProvider() [1/3]

◆ ParameterProvider() [2/3]

◆ ParameterProvider() [3/3]

◆ ~ParameterProvider()

Member Function Documentation

◆ get() [1/14]

◆ get() [2/14]

◆ get() [3/14]

◆ get() [4/14]

◆ get() [5/14]

◆ get() [6/14]

◆ get() [7/14]

◆ get() [8/14]

◆ get() [9/14]

◆ get() [10/14]

◆ get() [11/14]

◆ get() [12/14]

◆ get() [13/14]

◆ get() [14/14]

◆ getOptional() [1/4]

◆ getOptional() [2/4]

◆ getOptional() [3/4]

◆ getOptional() [4/4]

◆ getRequired() [1/4]

◆ getRequired() [2/4]

◆ getRequired() [3/4]

◆ getRequired() [4/4]

◆ operator=() [1/2]

◆ operator=() [2/2]