A sample of any complex data type, which can be inspected and manipulated reflectively. More...

#include <managed_dynamicdata.h>

Inheritance diagram for DDS::DynamicData:

Public Member Functions
virtual System::Boolean	copy_from (DynamicData^ other)
	Deeply copy from the given object to this object.

	DynamicData (DDS::TypeCode^ type, DynamicDataProperty_t^ property)
	The constructor for new DDS::DynamicData objects.

System::Boolean	is_valid ()
	Indicates whether the object was constructed properly.

void	copy (DynamicData^ src)
	Deeply copy from the given object to this object.

System::Boolean	equal (DynamicData^ other)
	Indicate whether the contents of another DDS::DynamicData sample are the same as those of this one.

void	clear_all_members ()
	Clear the contents of all data members of this object, including key members.

void	clear_nonkey_members ()
	Clear the contents of all data members of this object, not including key members.

void	clear_member (System::String^ member_name, System::Int32 member_id)
	Clear the contents of a single data member of this object.

void	get_info (DynamicDataInfo^ info_out)
	Fill in the given descriptor with information about this DDS::DynamicData.

void	bind_type (DDS::TypeCode^ type)
	If this DDS::DynamicData object is not yet associated with a data type, set that type now to the given DDS::TypeCode.

void	unbind_type ()
	Dissociate this DDS::DynamicData object from any particular data type.

void	bind_complex_member (DynamicData^ value_out, System::String^ member_name, System::Int32 member_id)
	Use another DDS::DynamicData object to provide access to a complex field of this DDS::DynamicData object.

void	unbind_complex_member (DynamicData^ value)
	Tear down the association created by a DDS::DynamicData::bind_complex_member operation, committing any changes to the outer object since then.

DDS::TypeCode^	get_type ()
	Get the data type, of which this DDS::DynamicData represents an instance.

TCKind	get_type_kind ()
	Get the kind of this object's data type.

System::UInt32	get_member_count ()
	Get the number of members in this sample.

System::Boolean	member_exists (System::String^ member_name, System::Int32 member_id)
	Indicates whether a member of a particular name/ID exists in this data sample.

System::Boolean	member_exists_in_type (System::String^ member_name, System::Int32 member_id)
	Indicates whether a member of a particular name/ID exists in this data sample's type.

void	get_member_info (DynamicDataMemberInfo^ info, System::String^ member_name, System::Int32 member_id)
	Fill in the given descriptor with information about the identified member of this DDS::DynamicData sample.

void	get_member_info_by_index (DynamicDataMemberInfo^ info, System::UInt32 index)
	Fill in the given descriptor with information about the identified member of this DDS::DynamicData sample.

void	get_member_type (DDS::TypeCode^ %type_out, System::String^ member_name, System::Int32 member_id)
	Get the type of the given member of this sample.

System::Boolean	is_member_key (System::String^ member_name, System::Int32 member_id)
	Indicates whether a given member forms part of the key of this sample's data type.

System::Int32	get_int (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Int32 or another type implicitly convertible to it (System::Byte, System::Char, System::Int16, System::UInt16, or ::DDS::Enum).

System::Int16	get_short (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Int16 or another type implicitly convertible to it (System::Byte or System::Char).

System::UInt32	get_uint (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::UInt32 or another type implicitly convertible to it (System::Byte, System::Char, System::Int16, System::UInt16, or ::DDS::Enum).

System::UInt16	get_ushort (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::UInt16 or another type implicitly convertible to it (System::Byte or System::Char).

System::Single	get_float (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Single.

System::Double	get_double (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Double or another type implicitly convertible to it (System::Single).

System::Boolean	get_boolean (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Boolean.

System::Char	get_char (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Char.

System::Byte	get_byte (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Byte.

System::Int64	get_long (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Int64 or another type implicitly convertible to it (System::Byte, System::Char, System::Int16, System::UInt16, System::Int32, System::UInt32, or ::DDS::Enum).

System::UInt64	get_ulong (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::UInt64 or another type implicitly convertible to it (System::Byte, System::Char, System::Int16, System::UInt16, System::Int32, System::UInt32, or ::DDS::Enum).

LongDouble	get_longdouble (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type DDS::LongDouble or another type implicitly convertible to it (System::Single or System::Double).

System::Char	get_wchar (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::Char or another type implicitly convertible to it (System::Char).

System::String^	get_string (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::String.

System::String^	get_wstring (System::String^ member_name, System::Int32 member_id)
	Get the value of the given field, which is of type System::String.

void	get_complex_member (DynamicData^ value_out, System::String^ member_name, System::Int32 member_id)
	Get a copy of the value of the given field, which is of some composed type.

void	get_int_array (array< System::Int32 >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_short_array (array< System::Int16 >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_uint_array (array< System::UInt32 >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_ushort_array (array< System::UInt16 >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_float_array (array< System::Single >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_double_array (array< System::Double >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_boolean_array (array< System::Boolean >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_char_array (array< System::Char >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_byte_array (array< System::Byte >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_long_array (array< System::Int64 >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_ulong_array (array< System::UInt64 >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_longdouble_array (array< LongDouble >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_wchar_array (array< System::Char >^array, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given array member.

void	get_int_seq (IntSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_short_seq (ShortSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_uint_seq (UnsignedIntSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_ushort_seq (UnsignedShortSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_float_seq (FloatSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_double_seq (DoubleSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_boolean_seq (BooleanSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_char_seq (CharSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_byte_seq (ByteSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_long_seq (LongSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_ulong_seq (UnsignedLongSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_longdouble_seq (LongDoubleSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	get_wchar_seq (WcharSeq^ seq, System::String^ member_name, System::Int32 member_id)
	Get a copy of the given sequence member.

void	set_int (System::String^ member_name, System::Int32 member_id, System::Int32 value)
	Set the value of the given field, which is of type System::Int32.

void	set_short (System::String^ member_name, System::Int32 member_id, System::Int16 value)
	Set the value of the given field, which is of type System::Int16.

void	set_uint (System::String^ member_name, System::Int32 member_id, System::UInt32 value)
	Set the value of the given field, which is of type System::UInt32.

void	set_ushort (System::String^ member_name, System::Int32 member_id, System::UInt16 value)
	Set the value of the given field, which is of type System::UInt16.

void	set_float (System::String^ member_name, System::Int32 member_id, System::Single value)
	Set the value of the given field, which is of type System::Single.

void	set_double (System::String^ member_name, System::Int32 member_id, System::Double value)
	Set the value of the given field, which is of type System::Double.

void	set_boolean (System::String^ member_name, System::Int32 member_id, System::Boolean value)
	Set the value of the given field, which is of type System::Boolean.

void	set_char (System::String^ member_name, System::Int32 member_id, System::Char value)
	Set the value of the given field, which is of type System::Char.

void	set_byte (System::String^ member_name, System::Int32 member_id, System::Byte value)
	Set the value of the given field, which is of type System::Byte.

void	set_long (System::String^ member_name, System::Int32 member_id, System::Int64 value)
	Set the value of the given field, which is of type System::Int64.

void	set_ulong (System::String^ member_name, System::Int32 member_id, System::UInt64 value)
	Set the value of the given field, which is of type System::UInt64.

void	set_longdouble (System::String^ member_name, System::Int32 member_id, LongDouble value)
	Set the value of the given field, which is of type DDS::LongDouble.

void	set_wchar (System::String^ member_name, System::Int32 member_id, System::Char value)
	Set the value of the given field, which is of type System::Char.

void	set_string (System::String^ member_name, System::Int32 member_id, System::String^ value)
	Set the value of the given field of type System::String.

void	set_wstring (System::String^ member_name, System::Int32 member_id, System::String^ value)
	Set the value of the given field of type System::String.

void	set_complex_member (System::String^ member_name, System::Int32 member_id, DynamicData^ value)
	Copy the state of the given DDS::DynamicData object into a member of this object.

void	set_int_array (System::String^ member_name, System::Int32 member_id, array< System::Int32 >^array)
	Set the contents of the given array member.

void	set_short_array (System::String^ member_name, System::Int32 member_id, array< System::Int16 >^array)
	Set the contents of the given array member.

void	set_uint_array (System::String^ member_name, System::Int32 member_id, array< System::UInt32 >^array)
	Set the contents of the given array member.

void	set_ushort_array (System::String^ member_name, System::Int32 member_id, array< System::UInt16 >^array)
	Set the contents of the given array member.

void	set_float_array (System::String^ member_name, System::Int32 member_id, array< System::Single >^array)
	Set the contents of the given array member.

void	set_double_array (System::String^ member_name, System::Int32 member_id, array< System::Double >^array)
	Set the contents of the given array member.

void	set_boolean_array (System::String^ member_name, System::Int32 member_id, array< System::Boolean >^array)
	Set the contents of the given array member.

void	set_char_array (System::String^ member_name, System::Int32 member_id, array< System::Char >^array)
	Set the contents of the given array member.

void	set_byte_array (System::String^ member_name, System::Int32 member_id, array< System::Byte >^array)
	Set the contents of the given array member.

void	set_long_array (System::String^ member_name, System::Int32 member_id, array< System::Int64 >^array)
	Set the contents of the given array member.

void	set_ulong_array (System::String^ member_name, System::Int32 member_id, array< System::UInt64 >^array)
	Set the contents of the given array member.

void	set_longdouble_array (System::String^ member_name, System::Int32 member_id, array< LongDouble >^array)
	Set the contents of the given array member.

void	set_wchar_array (System::String^ member_name, System::Int32 member_id, array< System::Char >^array)
	Set the contents of the given array member.

void	set_int_seq (System::String^ member_name, System::Int32 member_id, IntSeq^ value)
	Set the contents of the given sequence member.

void	set_short_seq (System::String^ member_name, System::Int32 member_id, ShortSeq^ value)
	Set the contents of the given sequence member.

void	set_uint_seq (System::String^ member_name, System::Int32 member_id, UnsignedIntSeq^ value)
	Set the contents of the given sequence member.

void	set_ushort_seq (System::String^ member_name, System::Int32 member_id, UnsignedShortSeq^ value)
	Set the contents of the given sequence member.

void	set_float_seq (System::String^ member_name, System::Int32 member_id, FloatSeq^ value)
	Set the contents of the given sequence member.

void	set_double_seq (System::String^ member_name, System::Int32 member_id, DoubleSeq^ value)
	Set the contents of the given sequence member.

void	set_boolean_seq (System::String^ member_name, System::Int32 member_id, BooleanSeq^ value)
	Set the contents of the given sequence member.

void	set_char_seq (System::String^ member_name, System::Int32 member_id, CharSeq^ value)
	Set the contents of the given sequence member.

void	set_byte_seq (System::String^ member_name, System::Int32 member_id, ByteSeq^ value)
	Set the contents of the given sequence member.

void	set_long_seq (System::String^ member_name, System::Int32 member_id, LongSeq^ value)
	Set the contents of the given sequence member.

void	set_ulong_seq (System::String^ member_name, System::Int32 member_id, UnsignedLongSeq^ value)
	Set the contents of the given sequence member.

void	set_longdouble_seq (System::String^ member_name, System::Int32 member_id, LongDoubleSeq^ value)
	Set the contents of the given sequence member.

void	set_wchar_seq (System::String^ member_name, System::Int32 member_id, WcharSeq^ value)
	Set the contents of the given sequence member.

	~DynamicData ()
	Finalize and deallocate this DDS::DynamicData sample.

Static Public Attributes
static System::Int32	MEMBER_ID_UNSPECIFIED
	A sentinel value that indicates that no member ID is needed in order to perform some operation.

static DynamicDataProperty_t^	DYNAMIC_DATA_PROPERTY_DEFAULT
	Sentinel constant indicating default values for DDS::DynamicDataProperty_t.

Detailed Description

A sample of any complex data type, which can be inspected and manipulated reflectively.

Objects of type DDS::DynamicData represent corresponding objects of the type identified by their DDS::TypeCode. Because the definition of these types may not have existed at compile time on the system on which the application is running, you will interact with the data using an API of reflective getters and setters.

For example, if you had access to your data types at compile time, you could do this:

theValue = theObject.theField;

Instead, you will do something like this:

theValue = get(theObject, "theField");

DDS::DynamicData objects can represent any complex data type, including those of type kinds ::DDS::TCKind::TK_ARRAY, ::DDS::TCKind::TK_SEQUENCE, ::DDS::TCKind::TK_STRUCT, ::DDS::TCKind::TK_UNION, ::DDS::TCKind::TK_VALUE, and ::DDS::TCKind::TK_SPARSE. They cannot represent objects of basic types (e.g. integers and strings). Since those type definitions always exist on every system, you can examine their objects directly.

Member Names and IDs

The members of a data type can be identified in one of two ways: by their name or by their numeric ID. The former is often more transparent to human users; the latter is typically faster.

You define the name and ID of a type member when you add that member to that type. When you define a sparse type, you will typically choose both explicitly. If you define your type in IDL or XML, the name will be the field name that appears in the type definition; the ID will be the one-based index of the field in declaration order. For example, in the following IDL structure, the ID of theLong is 2.

struct MyType { 
     short theShort; 
     long theLong; 
 }; 

For unions (::DDS::TCKind::TK_UNION), the ID of a member is the discriminator value corresponding to that member. To access the current discriminator of a union, you must use the DDS::DynamicData::get_member_info_by_index operation on the DynamicData object using an index value of 0. This operation fills in a DDS::DynamicDataMemberInfo, then you can access the populated DDS::DynamicDataMemberInfo::member_id field to get the current discriminator. Once you know the value of the discriminator, you can use it in the proper get/set_xxx() operations to access and set the member's value. Here is an example of accessing the discriminator:

DynamicDataMemberInfo memberInfo = new DynamicDataMemberInfo(); 
 myDynamicData.get_member_info_by_index(memberInfo, 0); 
 DynamicDataMemberId discriminatorValue = memberInfo.member_id; 
 DDS_Long myMemberValue = myDynamicData.get_long(NULL, discriminatorValue); 

Arrays and Sequences

The "members" of array and sequence types, unlike those of structure and union types, don't have names or explicit member IDs. However, they may nevertheless be accessed by "ID": the ID is one more than the index. (The first element has ID 1, the second 2, etc.)

Multi-dimensional arrays are effectively flattened by this pattern. For example, for an array theArray[4][5], accessing ID 7 is equivalent to index 6, or the second element of the second group of 5.

To determine the length of a collection-typed member of a structure or union, you have two choices:

Get the length along with the data: call the appropriate array accessor (see Getters and Setters) and check the resulting length.
Get the length without getting the data itself: call DDS::DynamicData::get_member_info and check the resulting DDS::DynamicDataMemberInfo::element_count.

Available Functionality

The Dynamic Data API is large when measured by the number of methods it contains. But each method falls into one of a very small number of categories. You will find it easier to navigate this documentation if you understand these categories.

Lifecycle and Utility Methods

Managing the lifecycle of DDS::DynamicData objects is simple. You have two choices:

Usually, you will go through a DDS::DynamicDataTypeSupport factory object, which will ensure that the type and property information for the new DDS::DynamicData object corresponds to a registered type in your system.
In certain advanced cases, such as when you're navigating a nested structure, you will want to have a DDS::DynamicData object that is not bound up front to any particular type, or you will want to initialize the object in a custom way. In that case, you can call the constructor directly.

Lifecycle
DDS::DynamicDataTypeSupport	DDS::DynamicData
DDS::DynamicDataTypeSupport::create_data	DDS::DynamicData::DynamicData

You can also copy DDS::DynamicData objects:

DDS::DynamicData::copy

You can test them for equality:

DDS::DynamicData::equal

Getters and Setters

Most methods get or set the value of some field. These methods are named according to the type of the field they access.

The names of integer types vary across languages. The programming API for each language reflects that programming language. However, if your chosen language does not use the same names as the language that you used to define your types (e.g., IDL), or if you need to interoperate among programming languages, you will need to understand these differences. They are explained the following table.

Integer Type Names Across Languages
Type	IDL	C, C++	C#	Java	Ada
16-bit integer	short	DDS_Short	short	short	integer (range: (2^15)..((2^15)-1))
32-bit integer	long	DDS_Long	int	int	integer (range: (2^31)..((2^31)-1))
64-bit integer	long long	DDS_LongLong	long	long	integer (range: (2^63)..((2^63)-1))

When working with a DDS::DynamicData object representing an array or sequence, calling one of the "get" methods below for an index that is out of bounds will result in DDS::Retcode_NoData. Calling "set" for an index that is past the end of a sequence will cause that sequence to automatically lengthen (filling with default contents).

When working with a DDS::DynamicData object whose type contains optional members, calling one of the "get" methods below on an unset optional member or any member that is part of an unset complex optional member will result in DDS::Retcode_NoData.

Basic Types
Get	Set
DDS::DynamicData::get_int	DDS::DynamicData::set_int
DDS::DynamicData::get_uint	DDS::DynamicData::set_uint
DDS::DynamicData::get_short	DDS::DynamicData::set_short
DDS::DynamicData::get_ushort	DDS::DynamicData::set_ushort
DDS::DynamicData::get_long	DDS::DynamicData::set_long
DDS::DynamicData::get_ulong	DDS::DynamicData::set_ulong
DDS::DynamicData::get_float	DDS::DynamicData::set_float
DDS::DynamicData::get_double	DDS::DynamicData::set_double
DDS::DynamicData::get_longdouble	DDS::DynamicData::set_longdouble
DDS::DynamicData::get_boolean	DDS::DynamicData::set_boolean
DDS::DynamicData::get_byte	DDS::DynamicData::set_byte
DDS::DynamicData::get_char	DDS::DynamicData::set_char
DDS::DynamicData::get_wchar	DDS::DynamicData::set_wchar
DDS::DynamicData::get_string	DDS::DynamicData::set_string
DDS::DynamicData::get_wstring	DDS::DynamicData::set_wstring

Structures, Arrays, and Other Complex Types
Get	Set
DDS::DynamicData::get_complex_member	DDS::DynamicData::set_complex_member

Arrays of Basic Types
Get	Set
DDS::DynamicData::get_int_array	DDS::DynamicData::set_int_array
DDS::DynamicData::get_uint_array	DDS::DynamicData::set_uint
DDS::DynamicData::get_short_array	DDS::DynamicData::set_short_array
DDS::DynamicData::get_ushort_array	DDS::DynamicData::set_ushort_array
DDS::DynamicData::get_long_array	DDS::DynamicData::set_long_array
DDS::DynamicData::get_ulong_array	DDS::DynamicData::set_ulong_array
DDS::DynamicData::get_float_array	DDS::DynamicData::set_float_array
DDS::DynamicData::get_double_array	DDS::DynamicData::set_double_array
DDS::DynamicData::get_longdouble_array	DDS::DynamicData::set_longdouble_array
DDS::DynamicData::get_boolean_array	DDS::DynamicData::set_boolean
DDS::DynamicData::get_byte_array	DDS::DynamicData::set_byte_array
DDS::DynamicData::get_char_array	DDS::DynamicData::set_char_array
DDS::DynamicData::get_wchar_array	DDS::DynamicData::set_wchar_array

Sequences of Basic Types
Get	Set
DDS::DynamicData::get_int_seq	DDS::DynamicData::set_int_seq
DDS::DynamicData::get_uint_seq	DDS::DynamicData::set_uint_seq
DDS::DynamicData::get_short_seq	DDS::DynamicData::set_short_seq
DDS::DynamicData::get_ushort_seq	DDS::DynamicData::set_ushort_seq
DDS::DynamicData::get_long_seq	DDS::DynamicData::set_long_seq
DDS::DynamicData::get_ulong_seq	DDS::DynamicData::set_ulong_seq
DDS::DynamicData::get_float_seq	DDS::DynamicData::set_float_seq
DDS::DynamicData::get_double_seq	DDS::DynamicData::set_double_seq
DDS::DynamicData::get_longdouble_seq	DDS::DynamicData::set_longdouble_seq
DDS::DynamicData::get_boolean_seq	DDS::DynamicData::set_boolean_seq
DDS::DynamicData::get_byte_seq	DDS::DynamicData::set_byte_seq
DDS::DynamicData::get_char_seq	DDS::DynamicData::set_char_seq
DDS::DynamicData::get_wchar_seq	DDS::DynamicData::set_wchar_seq

In addition to getting or setting a field, you can "clear" its value; that is, set it to a default zero value.

DDS::DynamicData::clear_member
DDS::DynamicData::clear_all_members
DDS::DynamicData::clear_nonkey_members
::DDS::DynamicData::clear_optional_member

Query and Iteration

Not all components of your application will have static knowledge of all of the fields of your type. Sometimes, you will want to query meta-data about the fields that appear in a given data sample.

Type/Object Association

Sometimes, you may want to change the association between a data object and its type. This is not something you can do with a typical object, but with DDS::DynamicData objects, it is a powerful capability. It allows you to, for example, examine nested structures without copying them by using a "bound" DDS::DynamicData object as a view into an enclosing DDS::DynamicData object.

Keys

Keys can be specified in dynamically defined types just as they can in types defined in generated code. However, there are some minor restrictions when sparse value types are involved (see ::DDS::TCKind::TK_SPARSE).

If a type has a member that is of a sparse value type, that member cannot be a key for the enclosing type.
Sparse value types themselves may have at most a single key field. That field may itself be of any type.

Performance

Due to the way in which DDS::DynamicData objects manage their internal state, it is typically more efficient, when setting the field values of a DDS::DynamicData for the first time, to do so in the declared order of those fields.

For example, suppose a type definition like the following:

struct MyType { 
     float my_float; 
     sequence<octet> my_bytes; 
     short my_short; 
 }; 

The richness of the type system makes it difficult to fully characterize the performance differences between all access patterns. Nevertheless, the following are generally true:

It will be most performant to set the value of my_float, then my_bytes, and finally my_short.
The order of modification has a greater impact for types of kind ::DDS::TCKind::TK_STRUCT and ::DDS::TCKind::TK_VALUE than it does for types of kind ::DDS::TCKind::TK_SPARSE.
Modifications to variable-sized types (i.e. those containing strings, sequences, unions, or optional members) are more expensive than modifications to fixed-size types.

MT Safety:: UNSAFE. In general, using a single DDS::DynamicData object concurrently from multiple threads is unsafe.

Constructor & Destructor Documentation

DDS::DynamicData::DynamicData	(	DDS::TypeCode^	type,
		DynamicDataProperty_t^	property
	)

The constructor for new DDS::DynamicData objects.

The type parameter may be null. In that case, this DDS::DynamicData must be bound with DDS::DynamicData::bind_type or DDS::DynamicData::bind_complex_member before it can be used.

If the DDS::TypeCode is not null, the newly constructed DDS::DynamicData object will retain a reference to it. It is not safe to delete the DDS::TypeCode until all samples that use it have themselves been deleted.

In most cases, it is not necessary to call this constructor explicitly. Instead, use DDS::DynamicDataTypeSupport::create_data, and the DDS::TypeCode and properties will be specified for you. Using the factory method also ensures that the memory management contract documented above is followed correctly, because the DDS::DynamicDataTypeSupport object maintains the DDS::TypeCode used by the samples it creates.

However you create a DDS::DynamicData object, you must delete it when you are finished with it. If you choose to use this constructor, delete the object with the destructor: ::DDS::DynamicData::delete.

In C#:

DynamicData sample = new DynamicData( 
     myType, myProperties); 
 // Do something... 
 sample.dispose(); 

In C++/CLI:

DynamicData^ sample = gcnew DynamicData( 
     myType, myProperties); 
 // Do something... 
 delete sample; 

Parameters

type	<<in>> The type of which the new object will represent an object.
property	<<in>> Properties that configure the behavior of the new object. Most users can simply use DDS::DynamicDataProperty_t::DYNAMIC_DATA_PROPERTY_DEFAULT.

See Also: ::DDS::DynamicData::delete; DDS::DynamicDataTypeSupport::create_data

DDS::DynamicData::~DynamicData ( )

Finalize and deallocate this DDS::DynamicData sample.

MT Safety:: UNSAFE.

See Also: DDS::DynamicData::DynamicData

Member Function Documentation

virtual System::Boolean DDS::DynamicData::copy_from ( DynamicData^ other )

virtual

Deeply copy from the given object to this object.

MT Safety:: UNSAFE.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::ICopyable

System::Boolean DDS::DynamicData::is_valid ( )

Indicates whether the object was constructed properly.

This method returns true if the constructor succeeded; it returns false if the constructor failed for any reason, which should also have resulted in a log message. It is only necessary to call this method if you created the DDS::DynamicData object using the constructor, DDS::DynamicData::DynamicData.

Possible failure reasons include passing an invalid type or invalid properties to the constructor.

This method is necessary because C++ exception support is not consistent across all of the platforms on which RTI Connext runs. Therefore, the implementation does not throw any exceptions in the constructor.

MT Safety:: UNSAFE.

See Also: DDS::DynamicData::DynamicData

void DDS::DynamicData::copy ( DynamicData^ src )

Deeply copy from the given object to this object.

MT Safety:: UNSAFE.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

System::Boolean DDS::DynamicData::equal ( DynamicData^ other )

Indicate whether the contents of another DDS::DynamicData sample are the same as those of this one.

This operation compares the data and type of existing members. The types of non-instantiated members may differ in sparse types.

MT Safety:: UNSAFE.

See Also: ::DDS::TCKind::TK_SPARSE

void DDS::DynamicData::clear_all_members ( )

Clear the contents of all data members of this object, including key members.

MT Safety:: UNSAFE.

Exceptions

One	of the Standard Return Codes

See Also: DDS::DynamicData::clear_nonkey_members; DDS::DynamicData::clear_member; ::DDS::DynamicData::clear_optional_member

void DDS::DynamicData::clear_nonkey_members ( )

Clear the contents of all data members of this object, not including key members.

This method is only applicable to sparse value types.

MT Safety:: UNSAFE.

Exceptions

One	of the Standard Return Codes

See Also: ::DDS::TCKind::TK_SPARSE; DDS::DynamicData::clear_all_members; DDS::DynamicData::clear_member; ::DDS::DynamicData::clear_optional_member

void DDS::DynamicData::clear_member	(	System::String^	member_name,
		System::Int32	member_id
	)

Clear the contents of a single data member of this object.

This method is only applicable to sparse value types.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes

See Also: ::DDS::TCKind::TK_SPARSE; DDS::DynamicData::clear_all_members; DDS::DynamicData::clear_nonkey_members

void DDS::DynamicData::get_info ( DynamicDataInfo^ info_out )

Fill in the given descriptor with information about this DDS::DynamicData.

MT Safety:: UNSAFE.

Parameters

info_out <<out>> The descriptor object whose contents will be overwritten by this operation.

void DDS::DynamicData::bind_type ( DDS::TypeCode^ type )

If this DDS::DynamicData object is not yet associated with a data type, set that type now to the given DDS::TypeCode.

This advanced operation allows you to reuse a single DDS::DynamicData object with multiple data types.

In C#:

DynamicData myData = new DynamicData(null, myProperties); 
 TypeCode myType = ...; 
 myData.bind_type(myType); 
 try { 
     // Do something... 
 } finally { 
     myData.unbind_type(); 
 } 
 myData.Dispose() 

In C++/CLI:

DynamicData^ myData = gcnew DynamicData(nullptr, myProperties); 
 TypeCode^ myType = ...; 
 myData->bind_type(myType); 
 try { 
     // Do something... 
 } finally { 
     myData->unbind_type(); 
 } 
 delete myData; 

Note that the DDS::DynamicData object will retain a reference to the DDS::TypeCode object you provide. It is not safe to delete the DDS::TypeCode until after it is unbound.

MT Safety:: UNSAFE.

Parameters

type	<<in>> The type to associate with this DDS::DynamicData object.

Exceptions

One	of the Standard Return Codes

See Also: DDS::DynamicData::unbind_type

void DDS::DynamicData::unbind_type ( )

Dissociate this DDS::DynamicData object from any particular data type.

This step is necessary before the object can be associated with a new data type.

This operation clears all members as a side effect.

MT Safety:: UNSAFE.

Exceptions

One	of the Standard Return Codes

See Also: DDS::DynamicData::bind_type; DDS::DynamicData::clear_all_members

void DDS::DynamicData::bind_complex_member	(	DynamicData^	value_out,
		System::String^	member_name,
		System::Int32	member_id
	)

Use another DDS::DynamicData object to provide access to a complex field of this DDS::DynamicData object.

For example, consider the following data types:

struct MyFieldType { 
     float theFloat; 
 }; 
 
 struct MyOuterType { 
     MyFieldType complexMember; 
 }; 

Suppose you have an instance of MyOuterType, and you would like to examine the contents of its member complexMember. To do this, you must bind another DDS::DynamicData object to that member. This operation will bind the type code of the member to the provided DDS::DynamicData object and perform additional initialization.

The following example demonstrates the usage pattern. Note that error handling has been omitted for brevity.

In C#:

DynamicData outer = ...; 
 DynamicData toBeBound = new DynamicData(null, myProperties); 
 outer.bind_complex_member( 
     toBeBound, 
     "complexMember", 
     DynamicData.MEMBER_ID_UNSPECIFIED); 
 try { 
     float theFloatValue = toBeBound.get_float( 
         "theFloat" 
         DynamicData.MEMBER_ID_UNSPECIFIED); 
 } finally { 
     outer.unbind_complex_member(toBeBound); 
 } 
 toBeBound.Dispose(); 

In C++/CLI:

DynamicData^ outer = ...; 
 DynamicData^ toBeBound = gcnew DynamicData(nullptr, myProperties); 
 outer->bind_complex_member( 
     toBeBound, 
     "complexMember", 
     DynamicData::MEMBER_ID_UNSPECIFIED); 
 try { 
     float theFloatValue = toBeBound->get_float( 
         "theFloat" 
         DynamicData::MEMBER_ID_UNSPECIFIED); 
 } finally { 
     outer->unbind_complex_member(toBeBound); 
 } 
 delete toBeBound; 

This operation is only permitted when the object toBeBound (named as in the example above) is not currently associated with any type, including already being bound to another member. You can see in the example that this object is created directly with the constructer and is not provided with a DDS::TypeCode.

Only a single member of a given DDS::DynamicData object may be bound at one time – however, members of members may be recursively bound to any depth. Furthermore, while the outer object has a bound member, it may only be modified through that bound member. That is, after calling this member, all "set" operations on the outer object will be disabled until DDS::DynamicData::unbind_complex_member has been called. Furthermore, any bound member must be unbound before a sample can be written or deleted.

This method is logically related to DDS::DynamicData::get_complex_member in that both allow you to examine the state of nested objects. They are different in an important way: this method provides a view into an outer object, such that any change made to the inner object will be reflected in the outer. But the DDS::DynamicData::get_complex_member operation copies the state of the nested object; changes to it will not be reflected in the source object.

Note that you can bind to a member of a sequence at an index that is past the current length of that sequence. In that case, this method behaves like a "set" method: it automatically lengthens the sequence (filling in default elements) to allow the bind to take place. See Getters and Setters.

MT Safety:: UNSAFE.

Parameters

value_out	<<out>> The object that you wish to bind to the field.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes

See Also: DDS::DynamicData::unbind_complex_member; DDS::DynamicData::get_complex_member

void DDS::DynamicData::unbind_complex_member ( DynamicData^ value )

Tear down the association created by a DDS::DynamicData::bind_complex_member operation, committing any changes to the outer object since then.

Some changes to the outer object will not be observable until after you have performed this operation.

If you have called DDS::DynamicData::bind_complex_member on a data sample, you must unbind before writing or deleting the sample.

MT Safety:: UNSAFE.

Parameters

value <<in>> The same object you passed to DDS::DynamicData::bind_complex_member. This argument is used for error checking purposes.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::bind_complex_member

DDS::TypeCode ^ DDS::DynamicData::get_type ( )

Get the data type, of which this DDS::DynamicData represents an instance.

MT Safety:: UNSAFE.

TCKind DDS::DynamicData::get_type_kind ( )

Get the kind of this object's data type.

This is a convenience method. It's equivalent to calling DDS::DynamicData::get_type followed by DDS::TypeCode::kind.

MT Safety:: UNSAFE.

System::UInt32 DDS::DynamicData::get_member_count ( )

Get the number of members in this sample.

For objects of type kind ::DDS::TCKind::TK_ARRAY or ::DDS::TCKind::TK_SEQUENCE, this method returns the number of elements in the collection.

For objects of type kind ::DDS::TCKind::TK_STRUCT or ::DDS::TCKind::TK_VALUE, it returns the number of fields in the sample, which will always be the same as the number of fields in the type.

For objects of type kind ::DDS::TCKind::TK_SPARSE, it returns the number of fields in the sample, which may be less than or equal to the number of fields in the type.

MT Safety:: UNSAFE.

See Also: DDS::DynamicData::get_member_info_by_index

System::Boolean DDS::DynamicData::member_exists	(	System::String^	member_name,
		System::Int32	member_id
	)

Indicates whether a member of a particular name/ID exists in this data sample.

Only one of the name and/or ID need by specified.

For objects of type kinds other than ::DDS::TCKind::TK_SPARSE, the result of this method will always be the same as that of DDS::DynamicData::member_exists_in_type.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

See Also: DDS::DynamicData::member_exists_in_type; DDS::DynamicData::MEMBER_ID_UNSPECIFIED

System::Boolean DDS::DynamicData::member_exists_in_type	(	System::String^	member_name,
		System::Int32	member_id
	)

Indicates whether a member of a particular name/ID exists in this data sample's type.

Only one of the name and/or ID need by specified.

For objects of type kinds other than ::DDS::TCKind::TK_SPARSE, the result of this method will always be the same as that of DDS::DynamicData::member_exists.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

See Also: DDS::DynamicData::member_exists; DDS::DynamicData::MEMBER_ID_UNSPECIFIED

void DDS::DynamicData::get_member_info	(	DynamicDataMemberInfo^	info,
		System::String^	member_name,
		System::Int32	member_id
	)

Fill in the given descriptor with information about the identified member of this DDS::DynamicData sample.

This operation is valid for objects of ::DDS::TCKind ::DDS::TCKind::TK_ARRAY, ::DDS::TCKind::TK_SEQUENCE, ::DDS::TCKind::TK_STRUCT, ::DDS::TCKind::TK_VALUE, and ::DDS::TCKind::TK_SPARSE.

MT Safety:: UNSAFE.

Parameters

info	<<out>> The descriptor object whose contents will be overwritten by this operations.
member_name	<<in>> The name of the member for which to get the info or null to look up the member by its ID. Only one of the name and the ID may be unspecified.
member_id	<<in>> The ID of the member for which to get the info, or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes

See Also: DDS::DynamicData::get_member_info_by_index; DDS::DynamicData::MEMBER_ID_UNSPECIFIED

void DDS::DynamicData::get_member_info_by_index	(	DynamicDataMemberInfo^	info,
		System::UInt32	index
	)

Fill in the given descriptor with information about the identified member of this DDS::DynamicData sample.

This operation is valid for objects of ::DDS::TCKind ::DDS::TCKind::TK_ARRAY, ::DDS::TCKind::TK_SEQUENCE, ::DDS::TCKind::TK_STRUCT, ::DDS::TCKind::TK_VALUE, ::DDS::TCKind::TK_UNION, and ::DDS::TCKind::TK_SPARSE.

MT Safety:: UNSAFE.

Parameters

info	<<out>> The descriptor object whose contents will be overwritten by this operations.
index	<<in>> The zero-base of the member for which to get the info.

Exceptions

One	of the Standard Return Codes

See Also: DDS::DynamicData::get_member_info; DDS::DynamicData::get_member_count; DDS::DynamicData::MEMBER_ID_UNSPECIFIED

void DDS::DynamicData::get_member_type	(	DDS::TypeCode^ %	type_out,
		System::String^	member_name,
		System::Int32	member_id
	)

Get the type of the given member of this sample.

The member can be looked up either by name or by ID.

This operation is valid for objects of ::DDS::TCKind ::DDS::TCKind::TK_ARRAY, ::DDS::TCKind::TK_SEQUENCE, ::DDS::TCKind::TK_STRUCT, ::DDS::TCKind::TK_VALUE, and ::DDS::TCKind::TK_SPARSE. For type kinds ::DDS::TCKind::TK_ARRAY and ::DDS::TCKind::TK_SEQUENCE, the index into the collection is taken to be one less than the ID, if specified. If this index is valid, this operation will return the content type of this collection.

MT Safety:: UNSAFE.

Parameters

type_out	<<out>> If this method returned success, this argument refers to the found member's type.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes

See Also: DDS::DynamicData::get_member_info; DDS::DynamicData::MEMBER_ID_UNSPECIFIED

System::Boolean DDS::DynamicData::is_member_key	(	System::String^	member_name,
		System::Int32	member_id
	)

Indicates whether a given member forms part of the key of this sample's data type.

This operation is only valid for samples of types of kind ::DDS::TCKind::TK_STRUCT, ::DDS::TCKind::TK_VALUE, or ::DDS::TCKind::TK_SPARSE.

Note to users of sparse types: A key member may only have a single representation and is required to exist in every sample.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes

System::Int32 DDS::DynamicData::get_int	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Int32 or another type implicitly convertible to it (System::Byte, System::Char, System::Int16, System::UInt16, or ::DDS::Enum).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_int

System::Int16 DDS::DynamicData::get_short	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Int16 or another type implicitly convertible to it (System::Byte or System::Char).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_short

System::UInt32 DDS::DynamicData::get_uint	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::UInt32 or another type implicitly convertible to it (System::Byte, System::Char, System::Int16, System::UInt16, or ::DDS::Enum).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_uint

System::UInt16 DDS::DynamicData::get_ushort	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::UInt16 or another type implicitly convertible to it (System::Byte or System::Char).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_ushort

System::Single DDS::DynamicData::get_float	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Single.

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_float

System::Double DDS::DynamicData::get_double	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Double or another type implicitly convertible to it (System::Single).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_double

System::Boolean DDS::DynamicData::get_boolean	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Boolean.

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_boolean

System::Char DDS::DynamicData::get_char	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Char.

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_char

System::Byte DDS::DynamicData::get_byte	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Byte.

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_byte

System::Int64 DDS::DynamicData::get_long	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Int64 or another type implicitly convertible to it (System::Byte, System::Char, System::Int16, System::UInt16, System::Int32, System::UInt32, or ::DDS::Enum).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_long

System::UInt64 DDS::DynamicData::get_ulong	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::UInt64 or another type implicitly convertible to it (System::Byte, System::Char, System::Int16, System::UInt16, System::Int32, System::UInt32, or ::DDS::Enum).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_ulong

LongDouble DDS::DynamicData::get_longdouble	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type DDS::LongDouble or another type implicitly convertible to it (System::Single or System::Double).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_longdouble

System::Char DDS::DynamicData::get_wchar	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::Char or another type implicitly convertible to it (System::Char).

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_wchar

System::String ^ DDS::DynamicData::get_string	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::String.

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_string

System::String ^ DDS::DynamicData::get_wstring	(	System::String^	member_name,
		System::Int32	member_id
	)

Get the value of the given field, which is of type System::String.

The member may be specified by name or by ID.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_wstring

void DDS::DynamicData::get_complex_member	(	DynamicData^	value_out,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the value of the given field, which is of some composed type.

The member may be of type kind ::DDS::TCKind::TK_ARRAY, ::DDS::TCKind::TK_SEQUENCE, ::DDS::TCKind::TK_STRUCT, ::DDS::TCKind::TK_VALUE, ::DDS::TCKind::TK_UNION, or ::DDS::TCKind::TK_SPARSE. It may be specified by name or by ID.

This method is logically related to DDS::DynamicData::bind_complex_member in that both allow you to examine the state of nested objects. They are different in an important way: this method provides a copy of the data; changes to it will not be reflected in the source object.

MT Safety:: UNSAFE.

Parameters

value_out	<<out>> The DDS::DynamicData sample whose contents will be overwritten by this operation. This object must not be a bound member of another DDS::DynamicData sample.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_complex_member; DDS::DynamicData::bind_complex_member

void DDS::DynamicData::get_int_array	(	array< System::Int32 >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from IntSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_int_array; DDS::DynamicData::get_int_seq

void DDS::DynamicData::get_short_array	(	array< System::Int16 >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from DDS::ShortSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_short_array; DDS::DynamicData::get_short_seq

void DDS::DynamicData::get_uint_array	(	array< System::UInt32 >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from UnsignedIntSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_uint; DDS::DynamicData::get_uint_seq

void DDS::DynamicData::get_ushort_array	(	array< System::UInt16 >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from DDS::UnsignedShortSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_ushort_array; DDS::DynamicData::get_ushort_seq

void DDS::DynamicData::get_float_array	(	array< System::Single >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from DDS::FloatSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_float_array; DDS::DynamicData::get_float_seq

void DDS::DynamicData::get_double_array	(	array< System::Double >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from DDS::DoubleSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_double_array; DDS::DynamicData::get_double_seq

void DDS::DynamicData::get_boolean_array	(	array< System::Boolean >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from DDS::BooleanSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_boolean_array; DDS::DynamicData::get_boolean_seq

void DDS::DynamicData::get_char_array	(	array< System::Char >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from DDS::CharSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_char_array; DDS::DynamicData::get_char_seq

void DDS::DynamicData::get_byte_array	(	array< System::Byte >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from ByteSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_byte_array; DDS::DynamicData::get_byte_seq

void DDS::DynamicData::get_long_array	(	array< System::Int64 >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from LongSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_long_array; DDS::DynamicData::get_long_seq

void DDS::DynamicData::get_ulong_array	(	array< System::UInt64 >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from ::DDS::UnsignedLongLongSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_ulong_array; DDS::DynamicData::get_ulong_seq

void DDS::DynamicData::get_longdouble_array	(	array< LongDouble >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from DDS::LongDoubleSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_longdouble_array; DDS::DynamicData::get_longdouble_seq

void DDS::DynamicData::get_wchar_array	(	array< System::Char >^	array,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given array member.

This method will perform an automatic conversion from DDS::WcharSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

array	<<out>> An already-allocated array, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData

See Also: DDS::DynamicData::set_wchar_array; DDS::DynamicData::get_wchar_seq

void DDS::DynamicData::get_int_seq	(	IntSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Int32.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_int_seq; DDS::DynamicData::get_int_array

void DDS::DynamicData::get_short_seq	(	ShortSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Int16.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_short_seq; DDS::DynamicData::get_short_array

void DDS::DynamicData::get_uint_seq	(	UnsignedIntSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::UInt32.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_uint_seq; DDS::DynamicData::get_uint_array

void DDS::DynamicData::get_ushort_seq	(	UnsignedShortSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::UInt16.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_ushort_seq; DDS::DynamicData::get_ushort_array

void DDS::DynamicData::get_float_seq	(	FloatSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Single.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_float_seq; DDS::DynamicData::get_float_array

void DDS::DynamicData::get_double_seq	(	DoubleSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Double.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_double_seq; DDS::DynamicData::get_double_array

void DDS::DynamicData::get_boolean_seq	(	BooleanSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Boolean.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_boolean_seq; DDS::DynamicData::get_boolean_array

void DDS::DynamicData::get_char_seq	(	CharSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Char.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_char_seq; DDS::DynamicData::get_char_array

void DDS::DynamicData::get_byte_seq	(	ByteSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Byte.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_byte_seq; DDS::DynamicData::get_byte_array

void DDS::DynamicData::get_long_seq	(	LongSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Int64.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_long_seq; DDS::DynamicData::get_long_array

void DDS::DynamicData::get_ulong_seq	(	UnsignedLongSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::UInt64.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_ulong_seq; DDS::DynamicData::get_ulong_array

void DDS::DynamicData::get_longdouble_seq	(	LongDoubleSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of DDS::LongDouble.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_longdouble_seq; DDS::DynamicData::get_longdouble_array

void DDS::DynamicData::get_wchar_seq	(	WcharSeq^	seq,
		System::String^	member_name,
		System::Int32	member_id
	)

Get a copy of the given sequence member.

The provided sequence will be automatically resized as necessary.

This method will perform an automatic conversion from an array of System::Char.

MT Safety:: UNSAFE.

Parameters

seq	<<out>> A sequence, into which the elements will be copied.
member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.

Exceptions

One	of the Standard Return Codes. If the member is optional and not set, this operation will return DDS::Retcode_NoData. This operation may also return DDS::Retcode_OutOfResources.

See Also: DDS::DynamicData::set_wchar_seq; DDS::DynamicData::get_wchar_array

void DDS::DynamicData::set_int	(	System::String^	member_name,
		System::Int32	member_id,
		System::Int32	value
	)

Set the value of the given field, which is of type System::Int32.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_int

void DDS::DynamicData::set_short	(	System::String^	member_name,
		System::Int32	member_id,
		System::Int16	value
	)

Set the value of the given field, which is of type System::Int16.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_short

void DDS::DynamicData::set_uint	(	System::String^	member_name,
		System::Int32	member_id,
		System::UInt32	value
	)

Set the value of the given field, which is of type System::UInt32.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_uint

void DDS::DynamicData::set_ushort	(	System::String^	member_name,
		System::Int32	member_id,
		System::UInt16	value
	)

Set the value of the given field, which is of type System::UInt16.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_ushort

void DDS::DynamicData::set_float	(	System::String^	member_name,
		System::Int32	member_id,
		System::Single	value
	)

Set the value of the given field, which is of type System::Single.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_float

void DDS::DynamicData::set_double	(	System::String^	member_name,
		System::Int32	member_id,
		System::Double	value
	)

Set the value of the given field, which is of type System::Double.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_double

void DDS::DynamicData::set_boolean	(	System::String^	member_name,
		System::Int32	member_id,
		System::Boolean	value
	)

Set the value of the given field, which is of type System::Boolean.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_boolean

void DDS::DynamicData::set_char	(	System::String^	member_name,
		System::Int32	member_id,
		System::Char	value
	)

Set the value of the given field, which is of type System::Char.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_char

void DDS::DynamicData::set_byte	(	System::String^	member_name,
		System::Int32	member_id,
		System::Byte	value
	)

Set the value of the given field, which is of type System::Byte.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_byte

void DDS::DynamicData::set_long	(	System::String^	member_name,
		System::Int32	member_id,
		System::Int64	value
	)

Set the value of the given field, which is of type System::Int64.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_long

void DDS::DynamicData::set_ulong	(	System::String^	member_name,
		System::Int32	member_id,
		System::UInt64	value
	)

Set the value of the given field, which is of type System::UInt64.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_ulong

void DDS::DynamicData::set_longdouble	(	System::String^	member_name,
		System::Int32	member_id,
		LongDouble	value
	)

Set the value of the given field, which is of type DDS::LongDouble.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_longdouble

void DDS::DynamicData::set_wchar	(	System::String^	member_name,
		System::Int32	member_id,
		System::Char	value
	)

Set the value of the given field, which is of type System::Char.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_char

void DDS::DynamicData::set_string	(	System::String^	member_name,
		System::Int32	member_id,
		System::String^	value
	)

Set the value of the given field of type System::String.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_string

void DDS::DynamicData::set_wstring	(	System::String^	member_name,
		System::Int32	member_id,
		System::String^	value
	)

Set the value of the given field of type System::String.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The value to which to set the member.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_wstring

void DDS::DynamicData::set_complex_member	(	System::String^	member_name,
		System::Int32	member_id,
		DynamicData^	value
	)

Copy the state of the given DDS::DynamicData object into a member of this object.

The member may be of type kind ::DDS::TCKind::TK_ARRAY, ::DDS::TCKind::TK_SEQUENCE, ::DDS::TCKind::TK_STRUCT, ::DDS::TCKind::TK_VALUE, ::DDS::TCKind::TK_UNION, or ::DDS::TCKind::TK_SPARSE. It may be specified by name or by ID.

Example: Copying Data

This method can be used with DDS::DynamicData::bind_complex_member to copy from one DDS::DynamicData object to another efficiently. Suppose the following data structure:

struct Bar { 
     short theShort; 
 }; 
 
 struct Foo { 
     Bar theBar; 
 }; 

Suppose we have two instances of Foo, foo_dst and foo_src, and we want to replace the contents of foo_dst.theBar with the contents of foo_src.theBar. The following example shows how to do this (error handling has been omitted for the sake of brevity).

In C#:

DynamicData foo_dst = ...; 
 DynamicData foo_src = ...; 
 DynamicData bar = new DynamicData(null, myProperties); 
 // Point to the source of the copy: 
 foo_src.bind_complex_member( 
     bar, 
     "theBar", 
     DynamicData.MEMBER_ID_UNSPECIFIED); 
 try { 
     // Just one copy: 
     foo_dst.set_complex_member( 
         "theBar", 
         DynamicData.MEMBER_ID_UNSPECIFIED, 
         bar); 
 } finally { 
     // Tear down: 
     foo_src.unbind_complex_member(bar); 
 } 
 bar.Dispose(); 

In C++/CLI:

DynamicData^ foo_dst = ...; 
 DynamicData^ foo_src = ...; 
 DynamicData^ bar = gcnew DynamicData(nullptr, myProperties); 
 // Point to the source of the copy: 
 foo_src->bind_complex_member( 
     bar, 
     "theBar", 
     DynamicData::MEMBER_ID_UNSPECIFIED); 
 try { 
     // Just one copy: 
     foo_dst->set_complex_member( 
         "theBar", 
         DynamicData::MEMBER_ID_UNSPECIFIED, 
         bar); 
 } finally { 
     // Tear down: 
     foo_src->unbind_complex_member(bar); 
 } 
 delete bar; 

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<in>> The source DDS::DynamicData object whose contents will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_complex_member; DDS::DynamicData::bind_complex_member

void DDS::DynamicData::set_int_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Int32 >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to IntSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_int_array; DDS::DynamicData::set_int_seq

void DDS::DynamicData::set_short_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Int16 >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to DDS::ShortSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_short_array; DDS::DynamicData::set_short_seq

void DDS::DynamicData::set_uint_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::UInt32 >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to UnsignedIntSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_uint_array; DDS::DynamicData::set_uint_seq

void DDS::DynamicData::set_ushort_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::UInt16 >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to DDS::UnsignedShortSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_ushort_array; DDS::DynamicData::set_ushort_seq

void DDS::DynamicData::set_float_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Single >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to DDS::FloatSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_float_array; DDS::DynamicData::set_float_seq

void DDS::DynamicData::set_double_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Double >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to DDS::DoubleSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_double_array; DDS::DynamicData::set_double_seq

void DDS::DynamicData::set_boolean_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Boolean >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to DDS::BooleanSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_boolean_array; DDS::DynamicData::set_boolean_seq

void DDS::DynamicData::set_char_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Char >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to DDS::CharSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_char_array; DDS::DynamicData::set_char_seq

void DDS::DynamicData::set_byte_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Byte >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to ByteSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_byte_array; DDS::DynamicData::set_byte_seq

void DDS::DynamicData::set_long_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Int64 >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to LongSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_long_array; DDS::DynamicData::set_long_seq

void DDS::DynamicData::set_ulong_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::UInt64 >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to ::DDS::UnsignedLongLongSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_ulong_array; DDS::DynamicData::set_ulong_seq

void DDS::DynamicData::set_longdouble_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< LongDouble >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to DDS::LongDoubleSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_longdouble_array; DDS::DynamicData::set_longdouble_seq

void DDS::DynamicData::set_wchar_array	(	System::String^	member_name,
		System::Int32	member_id,
		array< System::Char >^	array
	)

Set the contents of the given array member.

This method will perform an automatic conversion to DDS::WcharSeq.

If the destination array is insufficiently long to store the data, this operation will fail without copying anything.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
array	<<in>> The elements to copy.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_wchar_array; DDS::DynamicData::set_wchar_seq

void DDS::DynamicData::set_int_seq	(	System::String^	member_name,
		System::Int32	member_id,
		IntSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Int32.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_int_seq; DDS::DynamicData::set_int_array

void DDS::DynamicData::set_short_seq	(	System::String^	member_name,
		System::Int32	member_id,
		ShortSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Int16.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_short_seq; DDS::DynamicData::set_short_array

void DDS::DynamicData::set_uint_seq	(	System::String^	member_name,
		System::Int32	member_id,
		UnsignedIntSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::UInt32.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_uint_seq; DDS::DynamicData::set_uint

void DDS::DynamicData::set_ushort_seq	(	System::String^	member_name,
		System::Int32	member_id,
		UnsignedShortSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::UInt16.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_ushort_seq; DDS::DynamicData::set_ushort_array

void DDS::DynamicData::set_float_seq	(	System::String^	member_name,
		System::Int32	member_id,
		FloatSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Single.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_float_seq; DDS::DynamicData::set_float_array

void DDS::DynamicData::set_double_seq	(	System::String^	member_name,
		System::Int32	member_id,
		DoubleSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Double.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_double_seq; DDS::DynamicData::set_double_array

void DDS::DynamicData::set_boolean_seq	(	System::String^	member_name,
		System::Int32	member_id,
		BooleanSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Boolean.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_boolean_seq; DDS::DynamicData::set_boolean_array

void DDS::DynamicData::set_char_seq	(	System::String^	member_name,
		System::Int32	member_id,
		CharSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Char.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_char_seq; DDS::DynamicData::set_char_array

void DDS::DynamicData::set_byte_seq	(	System::String^	member_name,
		System::Int32	member_id,
		ByteSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Byte.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_byte_seq; DDS::DynamicData::set_byte_array

void DDS::DynamicData::set_long_seq	(	System::String^	member_name,
		System::Int32	member_id,
		LongSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Int64.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_long_seq; DDS::DynamicData::set_long_array

void DDS::DynamicData::set_ulong_seq	(	System::String^	member_name,
		System::Int32	member_id,
		UnsignedLongSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::UInt64.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_ulong_seq; DDS::DynamicData::set_ulong_array

void DDS::DynamicData::set_longdouble_seq	(	System::String^	member_name,
		System::Int32	member_id,
		LongDoubleSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of DDS::LongDouble.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_longdouble_seq; DDS::DynamicData::set_longdouble_array

void DDS::DynamicData::set_wchar_seq	(	System::String^	member_name,
		System::Int32	member_id,
		WcharSeq^	value
	)

Set the contents of the given sequence member.

This method will perform an automatic conversion to an array of System::Char.

MT Safety:: UNSAFE.

Parameters

member_name	<<in>> The name of the member or null to look up the member by its ID.
member_id	<<in>> The ID of the member or DDS::DynamicData::MEMBER_ID_UNSPECIFIED to look up by name. See Member Names and IDs.
value	<<out>> A sequence, from which the elements will be copied.

Exceptions

One	of the Standard Return Codes or DDS::Retcode_OutOfResources

See Also: DDS::DynamicData::get_wchar_seq; DDS::DynamicData::set_wchar_array

Public Member Functions

Static Public Attributes

Detailed Description

Member Names and IDs

Arrays and Sequences

Available Functionality

Lifecycle and Utility Methods

Getters and Setters

Query and Iteration

Type/Object Association

Keys

Performance

Constructor & Destructor Documentation

Member Function Documentation