Typedef dds_topic_filter_sample_fn

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