Struct FilterBuilder 

pub struct FilterBuilder<'a, 'b> { /* private fields */ }

Builder for constructing document filter expressions.

This struct provides methods for comparing document fields with values to create filter conditions.

Examples

// Combine multiple filter conditions
db.query("products")
    .filter(|f| {
        f.gte("price", 10.0) &&
        f.lte("price", 50.0) &&
        f.contains("name", "widget")
    })
    .collect()
    .await?;

Implementations

impl<'a, 'b> FilterBuilder<'a, 'b>

pub fn new(doc: &'b Document) -> Self

Create a new filter builder for the given document

pub fn eq<T: Into<Value>>(&self, field: &str, value: T) -> bool

Check if a field equals a value

Examples

.filter(|f| f.eq("status", "active"))

pub fn gt<T: Into<Value>>(&self, field: &str, value: T) -> bool

Check if a field is greater than a value

Examples

.filter(|f| f.gt("age", 21))

pub fn gte<T: Into<Value>>(&self, field: &str, value: T) -> bool

Check if a field is greater than or equal to a value

Examples

.filter(|f| f.gte("age", 21))

pub fn lt<T: Into<Value>>(&self, field: &str, value: T) -> bool

Check if a field is less than a value

Examples

.filter(|f| f.lt("age", 65))

pub fn lte<T: Into<Value>>(&self, field: &str, value: T) -> bool

Check if a field is less than or equal to a value

Examples

.filter(|f| f.lte("age", 65))

pub fn contains(&self, field: &str, value: &str) -> bool

Check if a field contains a value

Examples

.filter(|f| f.contains("name", "widget"))

pub fn in_values<T: Into<Value> + Clone>( &self, field: &str, values: &[T], ) -> bool

Check if a field is in a list of values

Examples

.filter(|f| f.in_values("status", &["active", "inactive"]))

pub fn between<T: Into<Value> + Clone>( &self, field: &str, min: T, max: T, ) -> bool

Check if a field is between two values (inclusive)

Examples

.filter(|f| f.between("age", 18, 65))

pub fn exists(&self, field: &str) -> bool

Check if a field exists and is not null

Examples

.filter(|f| f.exists("email"))

pub fn is_null(&self, field: &str) -> bool

Check if a field doesn’t exist or is null

Examples

.filter(|f| f.is_null("email"))

pub fn starts_with(&self, field: &str, prefix: &str) -> bool

Check if a field starts with a prefix

Examples

.filter(|f| f.starts_with("name", "John"))

pub fn ends_with(&self, field: &str, suffix: &str) -> bool

Check if a field ends with a suffix

Examples

.filter(|f| f.ends_with("name", "son"))

pub fn array_contains(&self, field: &str, value: impl Into<Value>) -> bool

Check if a field is in an array

Examples

.filter(|f| f.array_contains("status", "active"))

pub fn array_len_eq(&self, field: &str, len: usize) -> bool

Check if an array has a specific length

Examples

.filter(|f| f.array_len_eq("status", 2))

pub fn get_nested_value(&self, path: &str) -> Option<&Value>

Access a nested field using dot notation

Examples

.filter(|f| f.get_nested_value("user.address.city") == Some(&Value::String("New York")))

pub fn nested_eq<T: Into<Value>>(&self, path: &str, value: T) -> bool

Check if a nested field equals a value

Examples

.filter(|f| f.nested_eq("user.address.city", "New York"))

pub fn matches_regex(&self, field: &str, pattern: &str) -> bool

Check if a field matches a regular expression

Examples

.filter(|f| f.matches_regex("email", r"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$"))