uqa-execution 0.6.2

Volcano physical operators with row-batch pipelines
Documentation
//
// Unified Query Algebra
//
// Copyright (c) 2023-2026 Cognica, Inc.
//

//! Scalar evaluation over the shared SQL IR.

mod call_arguments;
mod context;
mod retained;
pub use retained::RetainedConstants;
mod evaluator;
pub mod plan;
mod state;
mod subquery;

pub use uqa_sql::ir::{
    ScalarExpr, ScalarFrameBound, ScalarOrder, ScalarWindowFrame, ScalarWindowSpec, SubqueryId,
};

pub use call_arguments::{
    eval_call_arguments, scalar_call_argument, scalar_call_arguments,
    validate_scalar_call_arguments, ScalarCallArgument,
};
pub(crate) use context::RetrievalPredicate;
pub use context::ScalarEvalContext;
pub(crate) use evaluator::scalar_integer_binary_width;
pub use evaluator::{eval_generated_scalar_with_control, eval_scalar};
pub use state::FunctionCallStates;
pub(crate) use state::PreparedExpressions;
pub(crate) use subquery::single_row_cardinality_error;
pub use subquery::{ScalarSubqueryRunner, SubqueryNeedle, SubqueryResult};

#[cfg(test)]
mod tests;

/// Evaluate an immutable scalar expression without row, parameter, or stateful-function inputs.
pub fn eval_constant_scalar(expression: &ScalarExpr) -> Result<uqa_core::Value, uqa_sql::SQLError> {
    eval_scalar(expression, &ScalarEvalContext::new(None, &[]))
}

/// Evaluate a planning constant with bound parameters and the statement's original allowance. This context has no row, query runner or runtime callbacks.
pub fn eval_constant_scalar_with_control(
    expression: &ScalarExpr,
    params: &[uqa_sql::SQLParam],
    control: &uqa_core::memory::ProductionControl<'_>,
) -> Result<uqa_core::memory::Produced<uqa_core::Value>, uqa_sql::SQLError> {
    evaluator::eval_scalar_inner(expression, &ScalarEvalContext::new(None, params), control)
}