User Data Type Support

Defines generic classes and macros to support user data types. More...

Macros
#define	DDS_TYPESUPPORT_CPP(TTypeSupport, TData)
	Declares the interface required to support a user data type.

Typedefs
typedef DDS_HANDLE_TYPE_NATIVE	DDS_InstanceHandle_t
	Type definition for an instance handle.

Functions
FooDataReader DDSDataReader_impl	initialize_data (Foo *a_data)
	<<interface>> <<generic>> User data type specific interface.
DDS_Boolean	DDS_InstanceHandle_is_nil (const DDS_InstanceHandle_t *self)
	Compare this handle to DDS_HANDLE_NIL.

Variables
const DDS_InstanceHandle_t	DDS_HANDLE_NIL
	The NIL instance handle.

---

Detailed Description

Defines generic classes and macros to support user data types.

DDS specifies strongly typed interfaces to read and write user data. For each data class defined by the application, there is a number of specialised classes that are required to facilitate the type-safe interaction of the application with RTI Connext DDS Micro.

RTI Connext DDS Micro provides an automatic means to generate all these type-specific classes with the RTI IDL Compiler User Manual utility. The complete set of automatic classes created for a hypothetical user data type named Foo are shown below.

"Classes auto-created for an application data type named Foo"

The macros defined here declare the strongly typed APIs needed to support an arbitrary user defined data of type Foo.

---

Macro Definition Documentation

#define DDS_TYPESUPPORT_CPP	(		TTypeSupport,
			TData
	)

Declares the interface required to support a user data type.

Defines:

::FooTypeSupport TypeSupport of type Foo, i.e. FooTypeSupport

---

Typedef Documentation

typedef DDS_HANDLE_TYPE_NATIVE DDS_InstanceHandle_t

Type definition for an instance handle.

Handle to identiy different instances of the same DDSTopic of a certain type.

See also:

DDSDataWriter::register_instance_untyped

DDS_SampleInfo::instance_handle

---

Function Documentation

FooDataReader DDSDataReader_impl initialize_data

(

Foo *

a_data

)

<<interface>> <<generic>> User data type specific interface.

Defines the user data type specific interface generated for each application class.

The concrete user data type automatically generated by the implementation is an incarnation of this class.

See also:

DDS_TYPESUPPORT_CPP

<<eXtension>> Initialize data type.

The generated implementation of the operation knows how to initialize a data type. This method is typically called to initialize a data type that is allocated on the stack.

Parameters:

sample

<<inout>> Cannot be NULL.

Returns:

One of the Standard Return Codes

See also:

::FooTypeSupport::finalize_data

DDS_Boolean DDS_InstanceHandle_is_nil

(

const DDS_InstanceHandle_t *

self

)

Compare this handle to DDS_HANDLE_NIL.

Returns:

DDS_BOOLEAN_TRUE if the given instance handle is equal to DDS_HANDLE_NIL or DDS_BOOLEAN_FALSE otherwise.

See also:

::DDS_InstanceHandle_equals

---

Variable Documentation

const DDS_InstanceHandle_t DDS_HANDLE_NIL

The NIL instance handle.

Special DDS_InstanceHandle_t value

See also:

DDS_InstanceHandle_is_nil