Struct QueryFilter 

pub struct QueryFilter {

    pub rooms: Vec<String>,
    pub users: Vec<String>,
    pub content_search: Option<String>,
    pub content_regex: Option<Regex>,
    pub after_seq: Option<(String, u64)>,
    pub before_seq: Option<(String, u64)>,
    pub after_ts: Option<DateTime<Utc>>,
    pub before_ts: Option<DateTime<Utc>>,
    pub mention_user: Option<String>,
    pub public_only: bool,
    pub target_id: Option<(String, u64)>,
    pub limit: Option<usize>,
    pub ascending: bool,
}

Filter criteria for the room query subcommand (née room poll).

Constructed by the CLI flag parser and evaluated per-message. The limit and ascending fields control result set size and ordering; they are applied externally by the caller after filtering, not inside matches.

Fields

rooms: Vec<String>

Only include messages from these rooms. Empty = all rooms.

users: Vec<String>

Only include messages sent by these users. Empty = all users.

content_search: Option<String>

Only include messages whose content contains this substring (case-sensitive).

content_regex: Option<Regex>

Only include messages whose content matches this pre-compiled regex.

Compiled once at construction time. Callers should validate the pattern before building the filter (e.g. via Regex::new).

after_seq: Option<(String, u64)>

Only include messages whose sequence number is strictly greater than this value. Tuple is (room_id, seq). The constraint is skipped for messages whose room_id differs from the filter room.

before_seq: Option<(String, u64)>

Only include messages whose sequence number is strictly less than this value. Tuple is (room_id, seq). Skipped for messages from other rooms.

after_ts: Option<DateTime<Utc>>

Only include messages with a timestamp strictly after this instant.

before_ts: Option<DateTime<Utc>>

Only include messages with a timestamp strictly before this instant.

mention_user: Option<String>

Only include messages that @mention this username.

public_only: bool

Exclude DirectMessage variants (public-channel filter).

target_id: Option<(String, u64)>

Only include the single message with this exact (room_id, seq).

When set, all other seq-based filters are ignored; the match is exact. DM privacy is still enforced externally by the caller.

limit: Option<usize>

Maximum number of messages to return. Applied externally by the caller.

ascending: bool

If true, return messages oldest-first. If false, newest-first. Applied externally by the caller.

Implementations

impl QueryFilter

pub fn matches(&self, msg: &Message, room_id: &str) -> bool

Returns true if msg satisfies all constraints in this filter.

room_id is the room in which msg arrived; it is used when comparing against after_seq/before_seq (which carry their own room component).

Trait Implementations

impl Clone for QueryFilter

fn clone(&self) -> QueryFilter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryFilter

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

Formats the value using the given formatter.

impl Default for QueryFilter

fn default() -> QueryFilter

Returns the “default value” for a type.