Enum ScalarExpr 

pub enum ScalarExpr<F> {
    Column(F),
    Literal(Literal),
    Binary {
        left: Box<ScalarExpr<F>>,
        op: BinaryOp,
        right: Box<ScalarExpr<F>>,
    },
    Not(Box<ScalarExpr<F>>),
    IsNull {
        expr: Box<ScalarExpr<F>>,
        negated: bool,
    },
    Aggregate(AggregateCall<F>),
    GetField {
        base: Box<ScalarExpr<F>>,
        field_name: String,
    },
    Cast {
        expr: Box<ScalarExpr<F>>,
        data_type: DataType,
    },
    Compare {
        left: Box<ScalarExpr<F>>,
        op: CompareOp,
        right: Box<ScalarExpr<F>>,
    },
    Coalesce(Vec<ScalarExpr<F>>),
    ScalarSubquery(ScalarSubqueryExpr),
    Case {
        operand: Option<Box<ScalarExpr<F>>>,
        branches: Vec<(ScalarExpr<F>, ScalarExpr<F>)>,
        else_expr: Option<Box<ScalarExpr<F>>>,
    },
    Random,
}

Arithmetic scalar expression that can reference multiple fields.

Variants

Column(F)

Literal(Literal)

Binary

Fields

left: Box<ScalarExpr<F>>

op: BinaryOp

right: Box<ScalarExpr<F>>

Not(Box<ScalarExpr<F>>)

Logical NOT returning 1 for falsey inputs, 0 for truthy inputs, and NULL for NULL inputs.

IsNull

NULL test returning 1 when the operand is NULL (or NOT NULL when negated is true) and 0 otherwise. Returns NULL when the operand cannot be determined.

Fields

expr: Box<ScalarExpr<F>>

negated: bool

Aggregate(AggregateCall<F>)

Aggregate function call (e.g., COUNT(), SUM(col), etc.) This is used in expressions like COUNT() + 1

GetField

Extract a field from a struct expression. For example: user.address.city would be represented as GetField { base: GetField { base: Column(user), field_name: “address” }, field_name: “city” }

Fields

base: Box<ScalarExpr<F>>

field_name: String

Cast

Explicit type cast to an Arrow data type.

Fields

expr: Box<ScalarExpr<F>>

data_type: DataType

Compare

Comparison producing a boolean (1/0) result.

Fields

left: Box<ScalarExpr<F>>

op: CompareOp

right: Box<ScalarExpr<F>>

Coalesce(Vec<ScalarExpr<F>>)

First non-null expression in the provided list.

ScalarSubquery(ScalarSubqueryExpr)

Scalar subquery evaluated per input row.

Case

SQL CASE expression with optional operand and ELSE branch.

Fields

operand: Option<Box<ScalarExpr<F>>>

Optional operand for simple CASE (e.g., CASE x WHEN ...).

branches: Vec<(ScalarExpr<F>, ScalarExpr<F>)>

Ordered (WHEN, THEN) branches.

else_expr: Option<Box<ScalarExpr<F>>>

Optional ELSE result.

Random

Random number generator returning a float in [0.0, 1.0).

Follows the PostgreSQL/DuckDB standard: each evaluation produces a new pseudo-random value. No seed control is exposed at the SQL level.

Implementations

impl<F> ScalarExpr<F>

pub fn column(field: F) -> ScalarExpr<F>

pub fn literal<L>(lit: L) -> ScalarExpr<F>

where L: Into<Literal>,

pub fn binary( left: ScalarExpr<F>, op: BinaryOp, right: ScalarExpr<F>, ) -> ScalarExpr<F>

pub fn logical_not(expr: ScalarExpr<F>) -> ScalarExpr<F>

pub fn is_null(expr: ScalarExpr<F>, negated: bool) -> ScalarExpr<F>

pub fn aggregate(call: AggregateCall<F>) -> ScalarExpr<F>

pub fn get_field(base: ScalarExpr<F>, field_name: String) -> ScalarExpr<F>

pub fn cast(expr: ScalarExpr<F>, data_type: DataType) -> ScalarExpr<F>

pub fn compare( left: ScalarExpr<F>, op: CompareOp, right: ScalarExpr<F>, ) -> ScalarExpr<F>

pub fn coalesce(exprs: Vec<ScalarExpr<F>>) -> ScalarExpr<F>

pub fn scalar_subquery(id: SubqueryId, data_type: DataType) -> ScalarExpr<F>

pub fn case( operand: Option<ScalarExpr<F>>, branches: Vec<(ScalarExpr<F>, ScalarExpr<F>)>, else_expr: Option<ScalarExpr<F>>, ) -> ScalarExpr<F>

pub fn random() -> ScalarExpr<F>

impl<F> ScalarExpr<F>

where F: Display + Copy,

pub fn format_display(&self) -> String

Render a scalar expression as a human-readable string.

Trait Implementations

impl<F> Clone for ScalarExpr<F>

where F: Clone,

fn clone(&self) -> ScalarExpr<F>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<F> Debug for ScalarExpr<F>

where F: Debug,

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

Formats the value using the given formatter.

impl<F> ScalarExprTypeExt<F> for ScalarExpr<F>

where F: Hash + Eq + Copy,

fn infer_result_type<R>(&self, resolve_type: &mut R) -> Option<DataType>

where R: FnMut(F) -> Option<DataType>,

fn infer_result_type_from_arrays( &self, arrays: &HashMap<F, Arc<dyn Array>, FxBuildHasher>, ) -> DataType

fn contains_interval(&self) -> bool