19.2.11.2. WriterListener

class WriterListener

Class WriterListener with virtual method so the user can implement callbacks to certain events.

Public Functions

inline virtual void on_writer_matched(RTPSWriter *writer, const MatchingInfo &info)

This method is called when a new Reader is matched with this Writer by the builtin protocols

Parameters:

  • writer – Pointer to the RTPSWriter.

  • info – Matching Information.

inline virtual void on_offered_incompatible_qos(RTPSWriter *writer, eprosima::fastdds::dds::PolicyMask qos)

This method is called when a new Reader is discovered, with a Topic that matches that of a local writer, but with a requested QoS that is incompatible with the one offered by the local writer

Parameters:

  • writer – Pointer to the RTPSWriter.

  • qos – A mask with the bits of all incompatible Qos activated.

inline virtual void on_writer_change_received_by_all(RTPSWriter *writer, CacheChange_t *change)

This method is called when all the readers matched with this Writer acknowledge that a cache change has been received.

Parameters:
inline virtual void on_liveliness_lost(RTPSWriter *writer, const LivelinessLostStatus &status)

Method called when the liveliness of a writer is lost.

Parameters:

  • writer – The writer

  • status – The liveliness lost status

inline virtual void on_reader_discovery(RTPSWriter *writer, ReaderDiscoveryStatus reason, const GUID_t &reader_guid, const SubscriptionBuiltinTopicData *reader_info)

Method called when the discovery information of a reader regarding a writer changes.

Parameters:

  • writer – The writer.

  • reason – The reason motivating this method to be called.

  • reader_guid – The GUID of the reader for which the discovery information changed.

  • reader_info – Discovery information about the reader. Will be nullptr for reason REMOVED_READER.

inline virtual void on_incompatible_type(RTPSWriter *writer)

This method is called when a new Reader is discovered, with a Topic that matches the name of a local writer, but with an incompatible type

Parameters:

writer – Pointer to the RTPSWriter.