Struct SimpleFilterEvaluator 

pub struct SimpleFilterEvaluator {
    column_name: String,
    literal: Scalar<ArrayRef>,
    op: Operator,
    literal_list: Vec<Scalar<ArrayRef>>,
    regex: Option<Regex>,
    regex_negative: bool,
}

An inplace expr evaluator for simple filter. Only support

• col op literal
• literal op col

And the op is one of =, !=, >, >=, <, <=, or regex operators: ~, ~*, !~, !~*.

This struct contains normalized predicate expr. In the form of col op literal where the col is provided from input.

Fields

column_name: String

Name of the referenced column.

literal: Scalar<ArrayRef>

The literal value.

op: Operator

The operator.

literal_list: Vec<Scalar<ArrayRef>>

Only used when the operator is Or-chain.

regex: Option<Regex>

Pre-compiled regex. Only used when the operator is regex operators. If the regex is empty, it is also None.

regex_negative: bool

Whether the regex is negative.

Implementations

impl SimpleFilterEvaluator

pub fn new<T: Literal>( column_name: String, lit: T, op: Operator, ) -> Option<Self>

pub fn try_new(predicate: &Expr) -> Option<Self>

pub fn column_name(&self) -> &str

Get the name of the referenced column.

pub fn is_eq(&self) -> bool

pub fn is_not_eq(&self) -> bool

pub fn is_lt(&self) -> bool

pub fn is_lt_eq(&self) -> bool

pub fn is_gt(&self) -> bool

pub fn is_gt_eq(&self) -> bool

pub fn is_or_eq_chain(&self) -> bool

Returns true if this filter represents an OR chain of equality comparisons, e.g. col = lit1 OR col = lit2 ....

pub fn literal_value(&self) -> Option<Value>

Returns the literal as a [Value]. It returns None if the literal can’t be converted.

pub fn literal_list_values(&self) -> Option<Vec<Value>>

Returns the literal list as a list of [Value]s. It returns None if any literal can’t be converted.

pub fn evaluate_scalar(&self, input: &ScalarValue) -> Result<bool>

pub fn evaluate_array(&self, input: &ArrayRef) -> Result<BooleanBuffer>

pub fn evaluate_vector(&self, input: &VectorRef) -> Result<BooleanBuffer>

fn evaluate_datum( &self, input: &impl Datum, input_len: usize, ) -> Result<BooleanBuffer>

fn maybe_build_regex( operator: Operator, value: &ScalarValue, ) -> Result<(Option<Regex>, bool), ArrowError>

Builds a regex pattern from a scalar value and operator. Returns the (regex, negative) and if successful.

Returns Err if

• the value is not a string
• the regex pattern is invalid

The regex is None if

• the operator is not a regex operator
• the pattern is empty

fn regex_match(&self, input: &impl Datum) -> Result<BooleanArray, ArrowError>

Trait Implementations

impl Debug for SimpleFilterEvaluator

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

Formats the value using the given formatter.