Struct Field 

pub struct Field<T, V> { /* private fields */ }

Field accessor.

Carries both the column / serde-key name (used by downstream SQL-emitting consumers like djogi) and the in-memory extractor used by sassi’s predicate evaluator. The two halves let the same Field<T, V> value participate in a SQL WHERE emit on a backend AND a Rust-side evaluate() walk on a frontend, without diverging.

Internal storage is pub(crate) to keep the (name, extractor) pair stable post-construction. Use Field::name and Field::extract accessors instead of direct field access.

Example

use sassi::Field;

struct User { id: i64, age: u32 }

// Normally generated by `#[derive(Cacheable)]`; shown here for
// documentation:
let age_field: Field<User, u32> = Field::new("age", |u| &u.age);
let alice = User { id: 1, age: 30 };
assert_eq!(*age_field.extract(&alice), 30);
assert_eq!(age_field.name(), "age");

Implementations

impl<T, V> Field<T, V>

pub const fn new(name: &'static str, extract: fn(&T) -> &V) -> Self

Construct a new Field<T, V>. Normally invoked via the generated T::fields() constructor; available here for hand impls.

pub fn name(&self) -> &'static str

Column / serde-key name. Stable post-construction.

pub fn extract<'a>(&self, value: &'a T) -> &'a V

Apply the extractor to a value. Stable post-construction — the extractor cannot be reassigned, only invoked.

impl<T: 'static, V: PartialEq + Send + Sync + 'static> Field<T, V>

pub fn eq(&self, val: V) -> BasicPredicate<T>

field == value.

pub fn neq(&self, val: V) -> BasicPredicate<T>

field != value.

impl<T: 'static, V: PartialOrd + Send + Sync + 'static> Field<T, V>

pub fn gt(&self, val: V) -> BasicPredicate<T>

field > value.

pub fn gte(&self, val: V) -> BasicPredicate<T>

field >= value.

pub fn lt(&self, val: V) -> BasicPredicate<T>

field < value.

pub fn lte(&self, val: V) -> BasicPredicate<T>

field <= value.

pub fn between(&self, low: V, high: V) -> BasicPredicate<T>

low <= field <= high (inclusive on both ends).

Operand value layout: Arc<(V, V)> carrying (low, high).

impl<T: 'static, V: PartialEq + Send + Sync + 'static> Field<T, V>

pub fn in_(&self, vals: Vec<V>) -> BasicPredicate<T>

field IN (values…). Operand value layout: Arc<Vec<V>>.

pub fn not_in(&self, vals: Vec<V>) -> BasicPredicate<T>

field NOT IN (values…). Operand value layout: Arc<Vec<V>>.

impl<T: 'static, U: Send + Sync + 'static> Field<T, Option<U>>

pub fn is_null(&self) -> BasicPredicate<T>

field IS NULL. Only meaningful on Option<U> fields. Operand value layout: Arc<()> (no operand).

pub fn is_not_null(&self) -> BasicPredicate<T>

field IS NOT NULL. Only meaningful on Option<U> fields. Operand value layout: Arc<()> (no operand).

impl<T, V> Field<T, Option<V>>

pub fn some(&self) -> PresentField<T, V>

Compare only the present Some(V) value.

impl<T: 'static> Field<T, String>

pub fn contains(&self, needle: &str) -> BasicPredicate<T>

Case-sensitive substring match: field contains the needle. Operand value layout: Arc<String>.

pub fn icontains(&self, needle: &str) -> BasicPredicate<T>

Case-insensitive substring match using ASCII-only folding. Operand value layout: Arc<String> — original (non-lowered) needle for inspection.

pub fn starts_with(&self, prefix: &str) -> BasicPredicate<T>

field starts with the prefix (case-sensitive). Operand value layout: Arc<String>.

pub fn istarts_with(&self, prefix: &str) -> BasicPredicate<T>

field starts with the prefix (case-insensitive). Operand value layout: Arc<String> — original (non-lowered).

pub fn ends_with(&self, suffix: &str) -> BasicPredicate<T>

field ends with the suffix (case-sensitive). Operand value layout: Arc<String>.

pub fn iends_with(&self, suffix: &str) -> BasicPredicate<T>

field ends with the suffix (case-insensitive). Operand value layout: Arc<String> — original (non-lowered).

pub fn iexact(&self, val: &str) -> BasicPredicate<T>

field == value using ASCII-only case folding. Operand value layout: Arc<String> — original.

Trait Implementations

impl<T, V> Clone for Field<T, V>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, V> Debug for Field<T, V>

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

Formats the value using the given formatter.

impl<T: 'static, V: 'static> Default for Field<T, V>

fn default() -> Self

Returns the “default value” for a type.

impl<T, V> Copy for Field<T, V>