Struct NonStrictExpression

pub struct NonStrictExpression<E = BoxedExpression>(E);

An type-safe wrapper that indicates the inner expression can be evaluated in a non-strict manner, i.e., developers can directly call eval_infallible and eval_row_infallible without checking the result.

This is usually created by non-strict build functions like crate::expr::build_non_strict_from_prost and crate::expr::build_func_non_strict. It can also be created directly by NonStrictExpression::new_topmost, where only the evaluation of the topmost level expression node is non-strict and should be treated as a TODO.

Compared to crate::expr::wrapper::non_strict::NonStrict, this is more like an indicator applied on the root of an expression tree, while the latter is a wrapper that can be applied on each node of the tree and actually changes the behavior. As a result, NonStrictExpression does not implement Expression trait and instead deals directly with developers.

Tuple Fields

0: E

Implementations

impl<E> NonStrictExpression<E>

where E: Expression,

pub fn for_test(inner: E) -> NonStrictExpression

where E: 'static,

Create a non-strict expression directly wrapping the given expression.

Should only be used in tests as evaluation may panic.

pub fn new_topmost( inner: E, error_report: impl EvalErrorReport, ) -> NonStrictExpression<impl Expression>

Create a non-strict expression from the given expression, where only the evaluation of the topmost level expression node is non-strict (which is subtly different from crate::expr::build_non_strict_from_prost where every node is non-strict).

This should be used as a TODO.

pub fn return_type(&self) -> DataType

Get the return data type.

pub async fn eval_infallible(&self, input: &DataChunk) -> ArrayRef

Evaluate the expression in vectorized execution and assert it succeeds. Returns an array.

Use with expressions built in non-strict mode.

pub async fn eval_row_infallible(&self, input: &OwnedRow) -> Datum

Evaluate the expression in row-based execution and assert it succeeds. Returns a nullable scalar.

Use with expressions built in non-strict mode.

pub fn into_inner(self) -> E

Unwrap the inner expression.

pub fn inner(&self) -> &E

Get a reference to the inner expression.

Trait Implementations

impl<E: Debug> Debug for NonStrictExpression<E>

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

Formats the value using the given formatter.