Typedef dds_topic_filter_sample_fn¶
Defined in File dds.h
Typedef Documentation¶
-
typedef bool (*dds_topic_filter_sample_fn)(const void *sample)¶
Topic filter functions, as with the setters/getters: no guarantee that any of this will be maintained for backwards compatibility.
Sampleinfo is all zero when filtering in a write call (i.e., writer created using a filtered topic, which one perhaps shouldn’t be doing), otherwise it has as much filled in correctly as is possible given the context and the rest fixed:
sample_state DDS_SST_NOT_READ;
publication_handle set to writer’s instance handle
source_timestamp set to source timestamp of sample
ranks 0
valid_data true
instance_handle set to instance handle of existing instance if the sample matches an existing instance, otherwise to what the instance handle will be if it passes the filter
view_state set to instance view state if sample being filtered matches an existing instance, NEW if not
instance_state set to instance state if sample being filtered matches an existing instance, NEW if not
generation counts set to instance’s generation counts if the sample matches an existing instance instance, 0 if not