DDS::SubscriptionMatchedStatus Struct Reference

::DDS::StatusKind::SUBSCRIPTION_MATCHED_STATUS More...

#include <managed_subscription.h>

Public Attributes
System::Int32	total_count
	The total cumulative number of times the concerned DDS::DataReader discovered a "match" with a DDS::DataWriter.
System::Int32	total_count_change
	The change in total_count since the last time the listener was called or the status was read.
System::Int32	current_count
	The current number of writers with which the DDS::DataReader is matched.
System::Int32	current_count_peak
	<<extension>> The highest value that current_count has reached until now.
System::Int32	current_count_change
	The change in current_count since the last time the listener was called or the status was read.
InstanceHandle_t	last_publication_handle
	A handle to the last DDS::DataWriter that caused the status to change.

Detailed Description

::DDS::StatusKind::SUBSCRIPTION_MATCHED_STATUS

A "match" happens when the DDS::DataReader finds a DDS::DataWriter for the same DDS::Topic with an offered QoS that is compatible with that requested by the DDS::DataReader.

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

Examples:

HelloWorld_subscriber.cpp.

Member Data Documentation

System::Int32 DDS::SubscriptionMatchedStatus::total_count

The total cumulative number of times the concerned DDS::DataReader discovered a "match" with a DDS::DataWriter.

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

System::Int32 DDS::SubscriptionMatchedStatus::total_count_change

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

System::Int32 DDS::SubscriptionMatchedStatus::current_count

The current number of writers with which the DDS::DataReader is matched.

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

System::Int32 DDS::SubscriptionMatchedStatus::current_count_peak

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

System::Int32 DDS::SubscriptionMatchedStatus::current_count_change

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

InstanceHandle_t DDS::SubscriptionMatchedStatus::last_publication_handle

A handle to the last DDS::DataWriter that caused the status to change.