DDS_SubscriptionMatchedStatus Struct Reference
[DataReaders]

DDS_SUBSCRIPTION_MATCHED_STATUS More...

List of all members.

Public Attributes
DDS_Long	total_count
	The total cumulative number of times the concerned DDSDataReader discovered a "match" with a DDSDataWriter.
DDS_Long	total_count_change
	The change in total_count since the last time the listener was called or the status was read.
DDS_Long	current_count
	The current number of writers with which the DDSDataReader is matched.
DDS_Long	current_count_peak
	<<eXtension>> The highest value that current_count has reached until now.
DDS_Long	current_count_change
	The change in current_count since the last time the listener was called or the status was read.
DDS_InstanceHandle_t	last_publication_handle
	A handle to the last DDSDataWriter that caused the status to change.

---

Detailed Description

DDS_SUBSCRIPTION_MATCHED_STATUS

A "match" happens when the DDSDataReader finds a DDSDataWriter for the same DDSTopic with an offered QoS that is compatible with that requested by the DDSDataReader.

This status is also changed (and the listener, if any, called) when a match is ended. A local DDSDataReader will become "unmatched" from a remote DDSDataWriter when that DDSDataWriter goes away for any reason.

Examples:

HelloWorld_subscriber.cxx.

---

Member Data Documentation

DDS_Long DDS_SubscriptionMatchedStatus::total_count

The total cumulative number of times the concerned DDSDataReader discovered a "match" with a DDSDataWriter.

This number increases whenever a new match is discovered. It does not change when an existing match goes away.

DDS_Long DDS_SubscriptionMatchedStatus::total_count_change

The change in total_count since the last time the listener was called or the status was read.

DDS_Long DDS_SubscriptionMatchedStatus::current_count

The current number of writers with which the DDSDataReader is matched.

This number increases when a new match is discovered and decreases when an existing match goes away.

DDS_Long DDS_SubscriptionMatchedStatus::current_count_peak

<<eXtension>> The highest value that current_count has reached until now.

DDS_Long DDS_SubscriptionMatchedStatus::current_count_change

The change in current_count since the last time the listener was called or the status was read.

DDS_InstanceHandle_t DDS_SubscriptionMatchedStatus::last_publication_handle

A handle to the last DDSDataWriter that caused the status to change.