20.2.7.3. RTPSParticipantListener

class RTPSParticipantListener

Class RTPSParticipantListener with virtual method that the user can overload to respond to certain events.

Public Functions

inline virtual void on_participant_discovery(RTPSParticipant *participant, ParticipantDiscoveryStatus reason, const ParticipantBuiltinTopicData &info, bool &should_be_ignored)

This method is called when a new Participant is discovered, or a previously discovered participant changes its QOS or is removed.

Parameters:

  • participant – [out] Pointer to the Participant which discovered the remote participant.

  • reason – [out] Reason of the change in the status of the discovered participant.

  • info – [out] Remote participant information. User can take ownership of the object.

  • should_be_ignored – [out] Flag to indicate the library to automatically ignore the discovered Participant.

inline virtual void on_reader_discovery(RTPSParticipant *participant, ReaderDiscoveryStatus reason, const SubscriptionBuiltinTopicData &info, bool &should_be_ignored)

This method is called when a new Reader is discovered, or a previously discovered reader changes its QOS or is removed.

Parameters:

  • participant – [in] Pointer to the Participant which discovered the remote reader.

  • reason – [in] The reason motivating this method to be called.

  • info – [in] Remote reader information.

  • should_be_ignored – [out] Flag to indicate the library to automatically ignore the discovered reader.

inline virtual void on_writer_discovery(RTPSParticipant *participant, WriterDiscoveryStatus reason, const PublicationBuiltinTopicData &info, bool &should_be_ignored)

This method is called when a new Writer is discovered, or a previously discovered writer changes its QOS or is removed.

Parameters:

  • participant – [in] Pointer to the Participant which discovered the remote writer.

  • reason – [in] The reason motivating this method to be called.

  • info – [in] Remote writer information.

  • should_be_ignored – [out] Flag to indicate the library to automatically ignore the discovered writer.