DataWriter

DataWriter（数据写者）用于对某个主题实例进行发送。DataWriter 的主要接口如下表所示，注意为了实现不同数据类型的主题发送，DataWriter 需要被实例化为不同的子类对象（统称为 FooDataWriter），下表中列出的接口包括了 FooDataWriter 的接口。本文只对常用接口进行详细说明，其他可参考 DDS 规范。

表 1 DataWriter 接口

接口函数	接口功能
write	发送数据

Write

1) 函数原型

ReturnCode_t write(Foo& data,
		const InstanceHandle_t & handle);

2) 功能简介

发送数据。

3) 输入参数

Foo& data [in]：主题数据实例，即应用软件发布端需要通过 DDS 向网络上发送的数据。

const InstanceHandle_t & handle [in]：实例句柄，若使用带 Key 的主题，可以通过句柄制定要发送的是哪个实例。可使用默认值 HANDLE_NIL。

4) 输出参数

无。

5) 返回值

若成功执行则返回创建 0（RETCODE_OK），否则返回错误码。