<<interface>> com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type support.
More...
Static Public Member Functions |
static void | register_type (DomainParticipant participant, String type_name) |
| Allows an application to communicate to RTI Connext the existence of the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes data type.
|
|
static void | unregister_type (DomainParticipant participant, String type_name) |
| Allows an application to unregister the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes data type from RTI Connext. After calling unregister_type, no further communication using this type is possible.
|
|
static String | get_type_name () |
| Get the default name for the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type.
|
|
Detailed Description
<<interface>> com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type support.
Member Function Documentation
Allows an application to communicate to RTI Connext the existence of the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes data type.
By default, The com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes built-in type is automatically registered when a DomainParticipant is created using the type_name returned by com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport.get_type_name. Therefore, the usage of this function is optional and it is only required when the automatic built-in type registration is disabled using the participant property "dds.builtin_type.auto_register".
This method can also be used to register the same com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport with a com.rti.dds.domain.DomainParticipant using different values for the type_name.
If register_type
is called multiple times with the same com.rti.dds.domain.DomainParticipant and type_name
, the second (and subsequent) registrations are ignored by the operation.
- Parameters
-
- Exceptions
-
- MT Safety:
- UNSAFE on the FIRST call. It is not safe for two threads to simultaneously make the first call to register a type. Subsequent calls are thread safe.
- See Also
- com.rti.dds.domain.DomainParticipant.create_topic
Allows an application to unregister the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes data type from RTI Connext. After calling unregister_type, no further communication using this type is possible.
- Precondition
- The com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type with
type_name
is registered with the participant and all com.rti.dds.topic.Topic objects referencing the type have been destroyed. If the type is not registered with the participant, or if any com.rti.dds.topic.Topic is associated with the type, the operation will fail with com.rti.dds.infrastructure.RETCODE_ERROR.
- Postcondition
- All information about the type is removed from RTI Connext. No further communication using this type is possible.
- Parameters
-
participant | <<in>> the com.rti.dds.domain.DomainParticipant to unregister the data type com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes from. Cannot be null. |
type_name | <<in>> the type name under with the data type com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes is registered with the participant. The name should match a name that has been previously used to register a type with the participant. Cannot be null. |
- Exceptions
-
- MT Safety:
- SAFE.
- See Also
- com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport.register_type
static String get_type_name |
( |
| ) |
|
|
static |
Get the default name for the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type.
Can be used for calling com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport.register_type or creating com.rti.dds.topic.Topic.
- Returns
- default name for the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type.
- See Also
- com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport.register_type
-
com.rti.dds.domain.DomainParticipant.create_topic