Module comparison

Module comparison 

Source
Expand description

§Comparison Operations Kernels Module - High-Performance Element-wise Comparison Operations

Optimised comparison kernels providing comprehensive element-wise comparison operations across numeric, string, and categorical data types with SIMD acceleration and null-aware semantics. Foundation for filtering, conditional logic, and analytical query processing.

§Core Operations

  • Numeric comparisons: Equal, not equal, greater than, less than, greater/less than or equal
  • String comparisons: UTF-8 aware lexicographic ordering with efficient prefix matching
  • Categorical comparisons: Dictionary-encoded comparisons avoiding string materialisation
  • Null-aware semantics: Proper three-valued logic handling (true/false/null)
  • SIMD vectorisation: Hardware-accelerated bulk comparison operations
  • Bitmask operations: Efficient boolean result representation using bit manipulation

Constants§

W8
Auto-generated SIMD lane widths from build.rs SIMD lane count for 8-bit elements (u8, i8). Determined at build time based on target architecture capabilities, or overridden via SIMD_LANES_OVERRIDE.
W16
SIMD lane count for 16-bit elements (u16, i16). Determined at build time based on target architecture capabilities, or overridden via SIMD_LANES_OVERRIDE.
W32
SIMD lane count for 32-bit elements (u32, i32, f32). Determined at build time based on target architecture capabilities, or overridden via SIMD_LANES_OVERRIDE.
W64
SIMD lane count for 64-bit elements (u64, i64, f64). Determined at build time based on target architecture capabilities, or overridden via SIMD_LANES_OVERRIDE.

Functions§

cmp_bitmask_simd
SIMD-accelerated compare bitmask
cmp_bool
Performs vectorised boolean array comparisons with null mask handling.
cmp_dict_dict
Compare UTF-8 string or dictionary arrays using the specified comparison operator.
cmp_dict_str
Compare UTF-8 string or dictionary arrays using the specified comparison operator.
cmp_f32
Type-specific SIMD-accelerated comparison function with vectorised operations.
cmp_f64
Type-specific SIMD-accelerated comparison function with vectorised operations.
cmp_i32
Type-specific SIMD-accelerated comparison function with vectorised operations.
cmp_i64
Type-specific SIMD-accelerated comparison function with vectorised operations.
cmp_numeric
Unified numeric comparison dispatch with optional null mask support.
cmp_str_dict
Compare UTF-8 string or dictionary arrays using the specified comparison operator.
cmp_str_str
Compare UTF-8 string or dictionary arrays using the specified comparison operator.
cmp_u32
Type-specific SIMD-accelerated comparison function with vectorised operations.
cmp_u64
Type-specific SIMD-accelerated comparison function with vectorised operations.