Skip to main content

Module row

Module row 

Source
Expand description

Experimental support for strict scalar functions computed one row at a time.

This module is experimental and has no compatibility guarantees. External users must enable the unstable_row_fns Cargo feature before importing it.

A RowFn describes the typed operation while the framework owns columnar concerns such as decoding, constant handling, null propagation, allocation, and validity. Its RowFn::dispatch implementation uses a RowVisitor to select an ElementTuple and either an OutputElement or OutputSink for each supported dtype combination.

Unlike a general strict function, a RowFn cannot produce null from valid inputs.

A partially valid batch contains both valid and invalid rows. Skip-invalid runs the kernel only for valid rows without changing row positions.

Prepared visits move work derived from constant operands outside the hot loop. Deferred visits reduce compact failure evidence without constructing errors in that loop.

Structs§

InitializedElement
Proof that one uninitialized element row was initialized.
UninitElementSink
An element sink that leaves dense output uninitialized before the row loop.

Traits§

ElementTuple
Typed argument tuples for arities zero through twelve.
FailureEvidence
Compact failure evidence that can be OR-reduced across rows.
IndexedElementTuple
An argument tuple that supports a validated dense indexed traversal.
InputElement
An element type that can be read row-wise out of an input column.
OutputElement
An owned row value that can be built into an all-valid column.
OutputSink
A column allocated once per batch that a row closure writes into, one row at a time.
RowFn
A strict scalar function whose row kernel cannot produce null from valid inputs.
RowVisitor
A planning or execution visit at concrete input and output types.
SinkResult
The result of writing one row: success or an immediate error.
ViewLen
The number of rows addressable through a row-loop view.

Functions§

execute_rows
Execute a RowFn without using its blanket ScalarFnVTable implementation.
row_fn_return_dtype
Compute the return dtype of a RowFn kernel without invoking its blanket vtable.