RTI Connext Modern C++ API
Version 5.3.0
|
Working with data filters. More...
Working with data filters.
RTI Connext supports filtering data either during the exchange from dds::pub::DataWriter
to dds::sub::DataReader
, or after the data has been stored at the dds::sub::DataReader
.
Filtering during the exchange process is performed by a dds::topic::ContentFilteredTopic
, which is created by the dds::sub::DataReader
as a way of specifying a subset of the data samples that it wishes to receive.
Filtering samples that have already been received by the dds::sub::DataReader
is performed by creating a dds::sub::cond::QueryCondition
, which can then used to check for matching samples, be alerted when matching samples arrive, or retrieve matching samples.
Filtering may be performed on any topic, either keyed or un-keyed, except the built-in topics. Filtering may be performed on any field, subset of fields, or combination of fields, subject only to the limitations of the filter syntax.
The following #includes are needed for the examples on this page
Foo:
dds::topic::ContentFilteredTopic
is exactly the same as normal reads or takes, as described in DataReader Use Cases. dds::sub::cond::QueryCondition::parameters
(similar to dds::topic::ContentFilteredTopic::filter_parameters
)