Enum ScalarExpr 

pub enum ScalarExpr {
    Star,
    QualifiedStar(String),
    Default,
    Column(String),
    Position(usize),
    InternalColumn(InternalColumnRef),
    QualifiedColumn {
        qualifier: String,
        column: String,
    },
    Literal(Value),
    TypedLiteral {
        value: Value,
        ty: String,
        bound_type: Option<ColumnType>,
        parameter_index: Option<usize>,
    },
    Param(usize),
    Func {
        name: String,
        binding: Option<FunctionBinding>,
        args: Vec<Self>,
        distinct: bool,
        order_by: Vec<ScalarOrder>,
        order_syntax: FunctionOrderSyntax,
        filter: Option<Box<Self>>,
    },
    Array(Vec<Self>),
    Row(Vec<Self>),
    CompositeRow {
        items: Vec<Self>,
        binding: CompositeRowBinding,
        bound_type: Option<ColumnType>,
    },
    Binary {
        op: BinaryOp,
        lhs: Box<Self>,
        rhs: Box<Self>,
    },
    UnaryMinus(Box<Self>),
    Not(Box<Self>),
    And(Vec<Self>),
    Or(Vec<Self>),
    IsNull {
        expr: Box<Self>,
        negated: bool,
    },
    Between {
        expr: Box<Self>,
        low: Box<Self>,
        high: Box<Self>,
    },
    InList {
        expr: Box<Self>,
        list: Vec<Self>,
        negated: bool,
    },
    WindowCall {
        name: String,
        args: Vec<Self>,
        spec: ScalarWindowSpec,
        filter: Option<Box<Self>>,
        modifiers: WindowCallModifiers,
    },
    Case {
        base: Option<Box<Self>>,
        when: Vec<(Self, Self)>,
        else_branch: Option<Box<Self>>,
    },
    Cast {
        implicit: bool,
        expr: Box<Self>,
        ty: String,
    },
    ScalarSubquery(SubqueryId),
    Exists {
        subquery: SubqueryId,
        negated: bool,
    },
    InSubquery {
        expr: Box<Self>,
        subquery: SubqueryId,
        negated: bool,
    },
}

Variants

Star

QualifiedStar(String)

Default

Column(String)

Position(usize)

Logical position in an already-bound physical row schema. This variant is introduced only after relational binding so duplicate SQL labels remain independently addressable.

InternalColumn(InternalColumnRef)

Structural executor-only attribute, resolved independently of SQL relation and column names.

QualifiedColumn

Fields

qualifier: String

column: String

Literal(Value)

TypedLiteral

An already-coerced runtime datum whose declared type must survive lowering.

Fields

value: Value

ty: String

bound_type: Option<ColumnType>

Resolved identity of an already-bound datum, including domain OIDs and type modifiers.

parameter_index: Option<usize>

Original SQL parameter slot when specialization replaces a bare parameter.

Param(usize)

Func

Fields

name: String

binding: Option<FunctionBinding>

args: Vec<Self>

distinct: bool

order_by: Vec<ScalarOrder>

order_syntax: FunctionOrderSyntax

filter: Option<Box<Self>>

Array(Vec<Self>)

Row(Vec<Self>)

CompositeRow

Fields

items: Vec<Self>

binding: CompositeRowBinding

bound_type: Option<ColumnType>

Resolved result identity for physical inference without catalog callbacks.

Binary

Fields

op: BinaryOp

lhs: Box<Self>

rhs: Box<Self>

UnaryMinus(Box<Self>)

Not(Box<Self>)

And(Vec<Self>)

Or(Vec<Self>)

IsNull

Fields

expr: Box<Self>

negated: bool

Between

Fields

expr: Box<Self>

low: Box<Self>

high: Box<Self>

InList

Fields

expr: Box<Self>

list: Vec<Self>

negated: bool

WindowCall

A window function call; filter is an aggregate’s FILTER (WHERE ...) condition.

Fields

name: String

args: Vec<Self>

spec: ScalarWindowSpec

filter: Option<Box<Self>>

modifiers: WindowCallModifiers

Case

Fields

base: Option<Box<Self>>

when: Vec<(Self, Self)>

else_branch: Option<Box<Self>>

Cast

Fields

implicit: bool

Analysis introduced this coercion rather than retaining an explicit SQL cast. Stored definitions must distinguish array coercions from explicit constructor conversions.

expr: Box<Self>

ty: String

ScalarSubquery(SubqueryId)

Exists

Fields

subquery: SubqueryId

negated: bool

InSubquery

Fields

expr: Box<Self>

subquery: SubqueryId

negated: bool

Implementations

impl ScalarExpr

pub fn visit(&self, visitor: &mut impl FnMut(&Self))

Visit this expression and every nested scalar expression in pre-order.

pub fn try_visit<E>( &self, visitor: &mut impl FnMut(&Self) -> Result<bool, E>, ) -> Result<(), E>

Visit in pre-order, skipping a subtree when the visitor returns false and stopping immediately on its first error.

pub fn visit_mut(&mut self, visitor: &mut impl FnMut(&mut Self))

Visit this expression and every nested scalar expression mutably in pre-order: a node is visited before its children, so the children of a node the visitor replaces are those of the replacement.

pub fn collect_columns(&self, output: &mut BTreeSet<String>) -> bool

Collect every column needed to evaluate this expression. Returns false when evaluation needs row shape or a relational child that a projected field scan cannot provide.

pub fn try_visit_columns<'a, E>( &'a self, visitor: &mut impl FnMut(&'a str) -> Result<(), E>, ) -> Result<bool, E>

Borrow referenced column names in evaluation-tree order, stopping at the first visitor failure or unprojectable expression. Qualified references yield their column component, matching collect_columns; repeated references remain visible to the visitor. No name or result container is allocated by this traversal.

pub fn contains_window(&self) -> bool

pub fn contains_subquery(&self) -> bool

pub fn contains_parameter(&self) -> bool

pub fn contains_aggregate(&self, is_aggregate: &dyn Fn(&str) -> bool) -> bool

impl ScalarExpr

pub fn qualified_column( qualifier: impl Into<String>, column: impl Into<String>, ) -> Self

impl ScalarExpr

pub fn clone_with_control( &self, control: &ProductionControl<'_>, ) -> Result<Produced<Self>, CatalogRetentionError>

Copy a scalar tree, admitting every destination allocation before creating it and retaining the complete reservation. Subquery identities still refer to the enclosing plan’s query arena.

Trait Implementations

impl Clone for ScalarExpr

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScalarExpr

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ScalarExpr

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ScalarExpr

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ScalarExpr

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ScalarExpr