definition of the access_element namespace (codecs) More...

Classes
class	StructElementLegacy
	Legacy helper for the ddl::StructElement. More...

Functions
template<typename T>
a_util::result::Result	findIndex (const T &decoder, const std::string &element_name, size_t &index)

template<typename T>
a_util::result::Result	findStructIndex (const T &decoder, const std::string &struct_name, size_t &index)

template<typename T>
a_util::result::Result	findArrayIndex (const T &decoder, const std::string &array_name, size_t &index)

template<typename T>
a_util::result::Result	findArrayEndIndex (const T &decoder, const std::string &array_name, size_t &index)

template<typename T>
a_util::result::Result	getValue (const T &decoder, const std::string &element_name, void *value)

template<typename T>
a_util::result::Result	setValue (T &codec, const std::string &element_name, const void *value)

template<typename T>
a_util::variant::Variant	getValue (const T &decoder, const std::string &element_name)

template<typename T>
a_util::result::Result	setValue (T &codec, const std::string &element_name, const a_util::variant::Variant &value)

template<typename T>
a_util::variant::Variant	getValue (const T &decoder, size_t element_index)

template<typename T>
const void *	getValueAddress (const T &decoder, const std::string &element_name)

template<typename T>
void *	getValueAddress (T &codec, const std::string &element_name)

template<typename STRUCT, typename T>
const STRUCT *	getStructAddress (const T &decoder, const std::string &struct_name)

template<typename STRUCT, typename T>
STRUCT *	getStructAddress (T &codec, const std::string &struct_name)

template<typename T, typename CODEC>
a_util::result::Result	getStructValue (const CODEC &decoder, const std::string &struct_name, T *struct_value)

template<typename T, typename CODEC>
a_util::result::Result	setStructValue (CODEC &codec, const std::string &struct_name, const T *struct_value)

template<typename ARRAY_TYPE, typename T>
const ARRAY_TYPE *	getArrayAddress (const T &decoder, const std::string &array_name)

template<typename ARRAY_TYPE, typename T>
ARRAY_TYPE *	getArrayAddress (T &codec, const std::string &array_name)

template<typename CODEC>
a_util::result::Result	getArray (const CODEC &decoder, const std::string &array_name, const void *&start_address, size_t &size)

template<typename T, typename CODEC>
a_util::result::Result	getArrayValue (const CODEC &decoder, const std::string &array_name, T *array_value)

template<typename T>
a_util::result::Result	reset (T &codec, const std::string &element_name)

template<typename T>
std::string	getValueAsString (const T &decoder, size_t element_index)

template<typename T>
std::string	getValueAsString (const T &decoder, const std::string &element_name)

	_MAKE_RESULT (-20, ERR_STRUCT_ELEMENT_NOT_FOUND)
	Creates an a_util error ERR_AUTIL_NOT_FOUND.

Detailed Description

definition of the access_element namespace (codecs)

Function Documentation

◆ findArrayEndIndex()

template<typename T>

a_util::result::Result ddl::access_element::findArrayEndIndex	(	const T &	decoder,
		const std::string &	array_name,
		size_t &	index )

find the index of the first element after an array by name.

Parameters

[in]	decoder	The decoder or factory.
[in]	array_name	The name of the array.
[out]	index	The index of the found element.

Return values

ERR_NOT_FOUND No element with the requested name was found.

◆ findArrayIndex()

template<typename T>

a_util::result::Result ddl::access_element::findArrayIndex	(	const T &	decoder,
		const std::string &	array_name,
		size_t &	index )

find the index of the first element of an array by name.

Parameters

[in]	decoder	The decoder or factory.
[in]	array_name	The name of the array.
[out]	index	The index of the found element.

Return values

ERR_NOT_FOUND No element with the requested name was found.

◆ findIndex()

template<typename T>

a_util::result::Result ddl::access_element::findIndex	(	const T &	decoder,
		const std::string &	element_name,
		size_t &	index )

find the index of an element by name.

Parameters

[in]	decoder	The decoder or factory.
[in]	element_name	The name of the element.
[in,out]	index	The index of the found element. Unchanged if index is not found.

Returns: SUCCESS if index found, ERR_NOT_FOUND otherwise.

◆ findStructIndex()

template<typename T>

a_util::result::Result ddl::access_element::findStructIndex	(	const T &	decoder,
		const std::string &	struct_name,
		size_t &	index )

find the index of the first element of a sub-structure by name.

Parameters

[in]	decoder	The decoder or factory.
[in]	struct_name	The name of the sub-structure.
[out]	index	The index of the found element.

Return values

ERR_NOT_FOUND No element with the requested name was found.

◆ getArray()

template<typename CODEC>

a_util::result::Result ddl::access_element::getArray	(	const CODEC &	decoder,
		const std::string &	array_name,
		const void *&	start_address,
		size_t &	size )

Get information about an array.

Parameters

[in]	decoder	The decoder.
[in]	array_name	The name of the array.
[out]	start_address	The address of the first element of the array.
[out]	size	The byte size of all elements of that array.

Return values

ERR_NOT_FOUND No array with the requested name was found.

◆ getArrayAddress() [1/2]

template<typename ARRAY_TYPE, typename T>

const ARRAY_TYPE * ddl::access_element::getArrayAddress	(	const T &	decoder,
		const std::string &	array_name )

Get a pointer to an array by name.

Parameters

[in]	decoder	The decoder.
[in]	array_name	The name of the array.

Returns: Address of the array.

◆ getArrayAddress() [2/2]

template<typename ARRAY_TYPE, typename T>

ARRAY_TYPE * ddl::access_element::getArrayAddress	(	T &	codec,
		const std::string &	array_name )

Get a pointer to an array by name.

Parameters

[in]	codec	The codec.
[in]	array_name	The name of the array.

Returns: Address of the array.

◆ getArrayValue()

template<typename T, typename CODEC>

a_util::result::Result ddl::access_element::getArrayValue	(	const CODEC &	decoder,
		const std::string &	array_name,
		T *	array_value )

Copy an array out of the structure.

Parameters

[in]	decoder	The decoder.
[in]	array_name	The name of the array.
[out]	array_value	The location the array will be copied to.

Return values

ERR_NOT_FOUND No array with the requested name was found.

◆ getStructAddress() [1/2]

template<typename STRUCT, typename T>

const STRUCT * ddl::access_element::getStructAddress	(	const T &	decoder,
		const std::string &	struct_name )

Get a pointer to a sub-structure by name.

Parameters

[in]	decoder	The codec.
[in]	struct_name	The name of the structure.

Returns: Address of the sub-structure.

◆ getStructAddress() [2/2]

template<typename STRUCT, typename T>

STRUCT * ddl::access_element::getStructAddress	(	T &	codec,
		const std::string &	struct_name )

Get a pointer to a sub-structure by name.

Parameters

[in]	codec	The codec.
[in]	struct_name	The name of the structure.

Returns: Address of the sub-structure.

◆ getStructValue()

template<typename T, typename CODEC>

a_util::result::Result ddl::access_element::getStructValue	(	const CODEC &	decoder,
		const std::string &	struct_name,
		T *	struct_value )

Copy a sub-structure out of the structure.

Parameters

[in]	decoder	The decoder.
[in]	struct_name	The name of the structure.
[out]	struct_value	The location the sub-structure will be copied to.

Return values

ERR_NOT_FOUND No structure with the requested name was found.

◆ getValue() [1/3]

template<typename T>

a_util::variant::Variant ddl::access_element::getValue	(	const T &	decoder,
		const std::string &	element_name )

Get the value of an element by name.

Parameters

[in]	decoder	The decoder.
[in]	element_name	The name of the element.

Return values

The	value of the element.

◆ getValue() [2/3]

template<typename T>

a_util::result::Result ddl::access_element::getValue	(	const T &	decoder,
		const std::string &	element_name,
		void *	value )

Get the value of an element by name.

Parameters

[in]	decoder	The decoder.
[in]	element_name	The name of the element.
[out]	value	The location where the value should be copied to.

Return values

ERR_NOT_FOUND No element with the requested name was found.

◆ getValue() [3/3]

template<typename T>

a_util::variant::Variant ddl::access_element::getValue	(	const T &	decoder,
		size_t	element_index )

Get the value of an element by index.

Parameters

[in]	decoder	The decoder.
[in]	element_index	The index of the element.

Return values

The	value of the element.

◆ getValueAddress() [1/2]

template<typename T>

const void * ddl::access_element::getValueAddress	(	const T &	decoder,
		const std::string &	element_name )

Get a pointer to an element by name.

Parameters

[in]	decoder	The decoder.
[in]	element_name	The name of the element.

Returns: Address of the element.

◆ getValueAddress() [2/2]

template<typename T>

void * ddl::access_element::getValueAddress	(	T &	codec,
		const std::string &	element_name )

Get a pointer to an element by name.

Parameters

[in]	codec	The codec.
[in]	element_name	The name of the element.

Returns: Address of the element.

◆ getValueAsString() [1/2]

template<typename T>

std::string ddl::access_element::getValueAsString	(	const T &	decoder,
		const std::string &	element_name )

Get the value of an element as a string, using enum value names if available.

Parameters

[in]	decoder	The decoder.
[in]	element_name	The name of the element.

Returns: A string representation of the value.

◆ getValueAsString() [2/2]

template<typename T>

std::string ddl::access_element::getValueAsString	(	const T &	decoder,
		size_t	element_index )

Get the value of an element as a string, using enum value names if available.

Parameters

[in]	decoder	The decoder.
[in]	element_index	The index of the element.

Returns: A string representation of the value.

◆ reset()

template<typename T>

a_util::result::Result ddl::access_element::reset	(	T &	codec,
		const std::string &	element_name )

Set the value of the requested element to zero.

Parameters

[in]	codec	The codec.
[in]	element_name	The name of the element.

Return values

NOT_FOUND No element with the requested name was found.

◆ setStructValue()

template<typename T, typename CODEC>

a_util::result::Result ddl::access_element::setStructValue	(	CODEC &	codec,
		const std::string &	struct_name,
		const T *	struct_value )

Copy a sub-structure into the structure.

Parameters

[in]	codec	The codec.
[in]	struct_name	The name of the structure.
[in]	struct_value	The location the sub-structure will be copied from.

Return values

ERR_NOT_FOUND No structure with the requested name was found.

◆ setValue() [1/2]

template<typename T>

a_util::result::Result ddl::access_element::setValue	(	T &	codec,
		const std::string &	element_name,
		const a_util::variant::Variant &	value )

Set the value of an element by name.

Parameters

[in]	codec	The codec.
[in]	element_name	The name of the element.
[in]	value	The new value.

Return values

ERR_NOT_FOUND No element with the requested name was found.

◆ setValue() [2/2]

template<typename T>

a_util::result::Result ddl::access_element::setValue	(	T &	codec,
		const std::string &	element_name,
		const void *	value )

Set the value of an element by name.

Parameters

[in]	codec	The codec.
[in]	element_name	The name of the element.
[in]	value	The location where the value should be copied from.

Return values

ERR_NOT_FOUND No element with the requested name was found.

Classes

Functions

Detailed Description

Function Documentation

◆ findArrayEndIndex()

◆ findArrayIndex()

◆ findIndex()

◆ findStructIndex()

◆ getArray()

◆ getArrayAddress() [1/2]

◆ getArrayAddress() [2/2]

◆ getArrayValue()

◆ getStructAddress() [1/2]

◆ getStructAddress() [2/2]

◆ getStructValue()

◆ getValue() [1/3]

◆ getValue() [2/3]

◆ getValue() [3/3]

◆ getValueAddress() [1/2]

◆ getValueAddress() [2/2]

◆ getValueAsString() [1/2]

◆ getValueAsString() [2/2]

◆ reset()

◆ setStructValue()

◆ setValue() [1/2]

◆ setValue() [2/2]