Struct ContentFilteredTopic 

pub struct ContentFilteredTopic<T: DdsType> { /* private fields */ }

ContentFilteredTopic<T> — Sub-Topic eines Topic<T> mit Filter-Expression. Spec-Referenz: OMG DDS 1.4 §2.2.2.3.3.

“ContentFilteredTopic is a specialization of TopicDescription that allows for content-based subscriptions. The selection of the content is done using a filter_expression with parameters (filter_parameters).”

Die Filter-Expression ist ein SQL-Subset (DDS-DCPS Annex B, BNF): field op literal-or-param, AND/OR/NOT-Komposition, parens, LIKE. Der konkrete Parser sitzt in zerodds-sql-filter.

Lifecycle: das CFT haelt einen Klon des Related-Topics (shared Arc<TopicInner>) und ist clone-bar selbst. Filter-Parameter sind veraenderbar zur Laufzeit (Spec §2.2.2.3.3.7).

Implementations

impl<T: DdsType> ContentFilteredTopic<T>

pub fn get_filter_expression(&self) -> &str

Spec §2.2.2.3.3.4 get_filter_expression.

pub fn get_filter_parameters(&self) -> Vec<String>

Spec §2.2.2.3.3.5 get_filter_parameters.

pub fn set_filter_parameters(&self, params: Vec<String>) -> Result<()>

Spec §2.2.2.3.3.6 set_filter_parameters. Tauscht die Parameter (gleiche Anzahl bleibt nicht erzwungen — die Spec sagt “should match the number of %n tokens” als Empfehlung, wir verifizieren das hart).

Errors

BadParameter wenn ein %N-Index ausserhalb des neuen Vecs liegt.

pub fn get_related_topic(&self) -> &Topic<T>

Spec §2.2.2.3.3.3 get_related_topic.

pub fn evaluate<R: RowAccess>(&self, row: &R) -> Result<bool>

Wertet den Filter gegen ein decodiertes Sample aus. Liefert Ok(true) wenn das Sample passieren soll, Ok(false) wenn es gefiltert wird, Err wenn die Expression auf das Row-Schema nicht passt (Caller-Entscheidung: filter denies oder error).

Errors

• PreconditionNotMet wenn die Filter-Parameter-Lock vergiftet ist.
• BadParameter wenn ein Feld in der Expression im Row nicht existiert oder ein Type-Mismatch auftritt.

Trait Implementations

impl<T: DdsType> Clone for ContentFilteredTopic<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + DdsType> Debug for ContentFilteredTopic<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: DdsType> TopicDescription for ContentFilteredTopic<T>

fn get_type_name(&self) -> &str

Type-Name kommt vom Related-Topic — ein CFT teilt sich das Schema mit dem unterliegenden Topic.

fn get_name(&self) -> &str

Topic-Name (z.B. "ChatterTopic"). Spec §2.2.2.3.1 get_name.

fn get_participant(&self) -> &DomainParticipant

Owning Participant. Spec §2.2.2.3.1 get_participant.