Struct ConcatExpr 

pub struct ConcatExpr { /* private fields */ }

Concatenate zero or more expressions into a single array.

All child expressions must evaluate to arrays of the same dtype.

Examples

use vortex_array::{IntoArray, ToCanonical};
use vortex_buffer::buffer;
use vortex_expr::{ConcatExpr, Scope, lit};
use vortex_scalar::Scalar;

let example = ConcatExpr::new(vec![
    lit(Scalar::from(100)),
    lit(Scalar::from(200)),
    lit(Scalar::from(300)),
]);
let concatenated = example.evaluate(&Scope::empty(1)).unwrap();
assert_eq!(concatenated.len(), 3);

Implementations

impl ConcatExpr

pub fn new(values: Vec<ExprRef>) -> Self

pub fn new_expr(values: Vec<ExprRef>) -> ExprRef

pub fn values(&self) -> &[ExprRef]

Methods from Deref<Target = dyn VortexExpr>

pub fn id(&self) -> ExprId

pub fn is<V: VTable>(&self) -> bool

pub fn as_<V: VTable>(&self) -> &V::Expr

pub fn as_opt<V: VTable>(&self) -> Option<&V::Expr>

pub fn evaluate(&self, scope: &Scope) -> VortexResult<ArrayRef>

Compute result of expression on given batch producing a new batch

pub fn display_tree(&self) -> impl Display

Display the expression as a formatted tree structure.

This provides a hierarchical view of the expression that shows the relationships between parent and child expressions, making complex nested expressions easier to understand and debug.

Example

// Build a complex nested expression
let complex_expr = select(
    ["result"],
    and(
        not(eq(get_item("status", root()), lit("inactive"))),
        and(
            LikeExpr::new(get_item("name", root()), lit("%admin%"), false, false).into_expr(),
            gt(
                cast(get_item("score", root()), DType::Primitive(PType::F64, Nullability::NonNullable)),
                lit(75.0)
            )
        )
    )
);

println!("{}", complex_expr.display_tree());

This produces output like:

Select(include): {result}
└── Binary(and)
    ├── lhs: Not
    │   └── Binary(=)
    │       ├── lhs: GetItem(status)
    │       │   └── Root
    │       └── rhs: Literal(value: "inactive", dtype: utf8)
    └── rhs: Binary(and)
        ├── lhs: Like
        │   ├── child: GetItem(name)
        │   │   └── Root
        │   └── pattern: Literal(value: "%admin%", dtype: utf8)
        └── rhs: Binary(>)
            ├── lhs: Cast(target: f64)
            │   └── GetItem(score)
            │       └── Root
            └── rhs: Literal(value: 75f64, dtype: f64)

Trait Implementations

impl AnalysisExpr for ConcatExpr

fn stat_falsification(&self, _catalog: &mut dyn StatsCatalog) -> Option<ExprRef>

An expression over zone-statistics which implies all records in the zone evaluate to false.

fn max(&self, _catalog: &mut dyn StatsCatalog) -> Option<ExprRef>

An expression for the upper non-null bound of this expression, if available.

fn min(&self, _catalog: &mut dyn StatsCatalog) -> Option<ExprRef>

An expression for the lower non-null bound of this expression, if available.

fn nan_count(&self, _catalog: &mut dyn StatsCatalog) -> Option<ExprRef>

An expression for the NaN count for a column, if available.

fn field_path(&self) -> Option<FieldPath>

impl AsRef<dyn VortexExpr> for ConcatExpr

fn as_ref(&self) -> &dyn VortexExpr

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for ConcatExpr

fn clone(&self) -> ConcatExpr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConcatExpr

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

Formats the value using the given formatter.

impl Deref for ConcatExpr

type Target = dyn VortexExpr

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DisplayAs for ConcatExpr

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

fn child_names(&self) -> Option<Vec<String>>

impl From<ConcatExpr> for ExprRef

fn from(value: ConcatExpr) -> ExprRef

Converts to this type from the input type.

impl Hash for ConcatExpr

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoExpr for ConcatExpr

fn into_expr(self) -> ExprRef

Convert this type into an expression reference.

impl PartialEq for ConcatExpr

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ConcatExpr

impl StructuralPartialEq for ConcatExpr