Struct ruma_client_api::filter::FilterDefinition

#[non_exhaustive]
pub struct FilterDefinition<'a> {
    pub event_fields: Option<&'a [String]>,
    pub event_format: EventFormat,
    pub presence: Filter<'a>,
    pub account_data: Filter<'a>,
    pub room: RoomFilter<'a>,
}

A filter definition

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

event_fields: Option<&'a [String]>

List of event fields to include.

If this list is absent then all fields are included. The entries may include ‘.’ characters to indicate sub-fields. So [‘content.body’] will include the ‘body’ field of the ‘content’ object. A literal ‘.’ character in a field name may be escaped using a ’'. A server may include more fields than were requested.

event_format: EventFormat

The format to use for events.

‘client’ will return the events in a format suitable for clients. ‘federation’ will return the raw event as received over federation. The default is ‘client’.

presence: Filter<'a>

The presence updates to include.

account_data: Filter<'a>

The user account data that isn’t associated with rooms to include.

room: RoomFilter<'a>

Filters to be applied to room data.

Implementations

impl<'a> FilterDefinition<'a>

pub fn empty() -> Self

Creates an empty FilterDefinition.

You can also use the Default implementation.

pub fn ignore_all() -> Self

Creates a new FilterDefinition that can be used to ignore all events.

pub fn is_empty(&self) -> bool

Returns true if all fields are empty.

Trait Implementations

impl<'a> CanBeEmpty for FilterDefinition<'a>

fn is_empty(&self) -> bool

Check whether self is empty.

impl<'a> Clone for FilterDefinition<'a>

fn clone(&self) -> FilterDefinition<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for FilterDefinition<'a>

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

Formats the value using the given formatter.

impl<'a> Default for FilterDefinition<'a>

fn default() -> FilterDefinition<'a>

Returns the “default value” for a type.

impl<'a> From<FilterDefinition<'a>> for Filter<'a>

fn from(def: FilterDefinition<'a>) -> Self

Converts to this type from the input type.

impl<'a> Serialize for FilterDefinition<'a>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.