RTI Connext Modern C++ API  Version 6.1.0

<<extension>> <<value-type>> Provides additional information about the filter expression passed to the writer_compile method of rti::topic::WriterContentFilter More...

#include <rti/topic/ContentFilter.hpp>

Public Member Functions

 ExpressionProperty ()
 Create a default ExpressionProperty with key_only_filter = false and writer_side_filter_optimization = false. More...
 
 ExpressionProperty (bool the_key_only_filter, bool the_writer_side_filter_optimization)
 Create an ExpressionProperty with the provided key_only_filter, and writer_side_filter_optimization. More...
 
bool key_only_filter () const
 Get the value of key_only_filter. More...
 
ExpressionPropertykey_only_filter (bool the_key_only_filter)
 Set the value for key_only_filter, indicating if the filter expression is based only on key fields. In this case, RTI Connext itself can cache the filtering results. More...
 
bool writer_side_filter_optimization () const
 Get the value of writer_side_filter_optimization. More...
 
ExpressionPropertywriter_side_filter_optimization (bool the_writer_side_filter_optimization)
 Set the value for writer_side_filter_optimization, indicating if the filter implementation can cache the filtering result for the provided expression. More...
 

Detailed Description

<<extension>> <<value-type>> Provides additional information about the filter expression passed to the writer_compile method of rti::topic::WriterContentFilter

It is used by the filter implementation to indicate to the middleware whether or not the WriterContentFilter will cache the result of filter evaluation.

See also
rti::topic::WriterContentFilter

Constructor & Destructor Documentation

◆ ExpressionProperty() [1/2]

rti::topic::ExpressionProperty::ExpressionProperty ( )
inline

Create a default ExpressionProperty with key_only_filter = false and writer_side_filter_optimization = false.

◆ ExpressionProperty() [2/2]

rti::topic::ExpressionProperty::ExpressionProperty ( bool  the_key_only_filter,
bool  the_writer_side_filter_optimization 
)
inline

Create an ExpressionProperty with the provided key_only_filter, and writer_side_filter_optimization.

Parameters
the_key_only_filterThe value for key_only_filter
the_writer_side_filter_optimizationThe value for writer_side_filter_optimization

Member Function Documentation

◆ key_only_filter() [1/2]

bool rti::topic::ExpressionProperty::key_only_filter ( ) const
inline

Get the value of key_only_filter.

See also
key_only_filter(bool the_key_only_filter)

◆ key_only_filter() [2/2]

ExpressionProperty& rti::topic::ExpressionProperty::key_only_filter ( bool  the_key_only_filter)
inline

Set the value for key_only_filter, indicating if the filter expression is based only on key fields. In this case, RTI Connext itself can cache the filtering results.

When this field is set to true, it indicates to RTI Connext that the filter expression is based only on key fields.

Parameters
the_key_only_filterThe value to set for key_only_filter

◆ writer_side_filter_optimization() [1/2]

bool rti::topic::ExpressionProperty::writer_side_filter_optimization ( ) const
inline

Get the value of writer_side_filter_optimization.

See also
writer_side_filter_optimization(bool the_writer_side_filter_optimization)

◆ writer_side_filter_optimization() [2/2]

ExpressionProperty& rti::topic::ExpressionProperty::writer_side_filter_optimization ( bool  the_writer_side_filter_optimization)
inline

Set the value for writer_side_filter_optimization, indicating if the filter implementation can cache the filtering result for the provided expression.

When this field is set to true, RTI Connext will do no caching or explicit filter evaluation for the associated dds::sub::DataReader. Instead, it will rely on the filter implementation to provide appropriate results.

Parameters
the_writer_side_filter_optimizationThe value to set for writer_side_filter_optimization