Function dds_create_reader

Function Documentation

dds_entity_t dds_create_reader(dds_entity_t participant_or_subscriber, dds_entity_t topic, const dds_qos_t *qos, const dds_listener_t *listener)

Creates a new instance of a DDS reader.

When a participant is used to create a reader, an implicit subscriber is created. This implicit subscriber will be deleted automatically when the created reader is deleted.

Parameters

  • participant_or_subscriber – [in] The participant or subscriber on which the reader is being created.

  • topic – [in] The topic to read.

  • qos – [in] The QoS to set on the new reader (can be NULL).

  • listener – [in] Any listener functions associated with the new reader (can be NULL).

Return values

  • >0 – A valid reader handle.

  • DDS_RETCODE_ERROR – An internal error occurred.

Returns

A valid reader handle or an error code.