Struct BooleanArrayV 

pub struct BooleanArrayV {
    pub array: Arc<BooleanArray<()>>,
    pub offset: usize,
    /* private fields */
}

BooleanArrayView

Borrowed, indexable view into a [offset .. offset + len) window of a BooleanArray.

Purpose

• Zero-copy access to contiguous bit-packed boolean values.
• Allows null counts for the view to be cached to speed up scans.

Fields

• array: the backing BooleanArray wrapped in Arc.
• offset: starting index of the view.
• len: number of logical elements in the view.
• null_count: cached null count for this range.

Notes

• Use slice to derive smaller views from this one.
• Use to_boolean_array to materialise the data.

Fields

array: Arc<BooleanArray<()>>

The outer array that this view is derived from - we retain a reference to it. Importantly, this is the full array - not the view, and thus should not be accessed as though it were the view subset.

offset: usize

The index offset from 0 that for where this view starts from the outer array

Implementations

impl BooleanArrayV

pub fn new(array: Arc<BooleanArray<()>>, offset: usize, len: usize) -> Self

Creates a new BooleanArrayView with the given offset and length.

pub fn new_nc( array: Arc<BooleanArray<()>>, offset: usize, len: usize, null_count: usize, ) -> Self

Creates a new BooleanArrayView with a precomputed null count.

pub fn is_empty(&self) -> bool

Returns true if the view is empty.

pub fn get_bool(&self, i: usize) -> Option<bool>

Returns the value at logical index i as an Option<bool>.

pub fn slice(&self, offset: usize, len: usize) -> Self

Returns a sliced view into a subrange of this view.

pub fn len(&self) -> usize

Returns the length of the window.

pub fn inner_array(&self) -> Array

Returns the full backing array wrapped as an Array enum, ignoring the view’s offset and length.

Use this to access inner array methods. The returned array is the unwindowed original.

pub fn to_boolean_array(&self) -> Arc<BooleanArray<()>>

Returns an owned BooleanArray for the window.

If the view covers the entire backing array, returns a cheap Arc clone of the original allocation. Otherwise deep-copies the window via slice_clone through inner_array.

pub fn end(&self) -> usize

Returns the end index of the view.

pub fn as_tuple(&self) -> (Arc<BooleanArray<()>>, usize, usize)

Returns the view as a tuple (array, offset, len).

pub fn as_tuple_ref(&self) -> (&BooleanArray<()>, usize, usize)

Returns a reference tuple: (&BooleanArray, offset, len).

This avoids cloning the Arc and returns a reference with a lifetime tied to this BooleanArrayV.

pub fn null_count(&self) -> usize

Returns the number of nulls in the view.

Caches it after the first calculation.

pub fn has_nulls(&self) -> bool

Returns true when the windowed view holds at least one null.

Reads through null_count, so the cached value is trusted when set and the full popcount is only paid on the first call that observes this view.

pub fn null_mask_view(&self) -> Option<BitmaskV<'_>>

Returns the null mask as a windowed BitmaskView.

pub fn set_null_count(&self, count: usize) -> Result<(), usize>

Sets the cached null count for the view.

Returns Ok(()) if the value was set, or Err(count) if it was already initialised. This is thread-safe and can only succeed once per BooleanArrayV instance.

Trait Implementations

impl Clone for BooleanArrayV

fn clone(&self) -> BooleanArrayV

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Concatenate for BooleanArrayV

fn concat(self, other: Self) -> Result<Self, MinarrowError>

Concatenates two boolean array views by materialising both to owned boolean arrays, concatenating them, and wrapping the result back in a view.

Notes

• This operation copies data from both views to create owned boolean arrays.
• The resulting view has offset=0 and length equal to the combined length.

impl Debug for BooleanArrayV

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

Formats the value using the given formatter.

impl Display for BooleanArrayV

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

Formats the value using the given formatter.

impl From<Arc<BooleanArray<()>>> for BooleanArrayV

fn from(array: Arc<BooleanArray<()>>) -> Self

Converts to this type from the input type.

impl From<Array> for BooleanArrayV

fn from(array: Array) -> Self

Converts to this type from the input type.

impl From<ArrayV> for BooleanArrayV

fn from(view: ArrayV) -> Self

Converts to this type from the input type.

impl From<BooleanArrayV> for Value

Available on crate feature views only.

Wrap a BooleanArrayV as Value::ArrayView. The view’s offset and length are preserved on the inner ArrayV. The full null mask carried by the underlying BooleanArray is preserved.

fn from(v: BooleanArrayV) -> Self

Converts to this type from the input type.

impl From<BooleanArrayV> for ArrayV

Available on crate feature views only.

BooleanArrayView -> ArrayView

Converts by wrapping the inner Arc as Array::BooleanArray.

fn from(view: BooleanArrayV) -> Self

Converts to this type from the input type.

impl PartialEq for BooleanArrayV

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

Equality operator ==.

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

Inequality operator !=.

impl Shape for BooleanArrayV

fn shape(&self) -> ShapeDim

Returns arbitrary Shape dimension for any data shape

fn shape_1d(&self) -> usize

Returns the first dimension shape

fn shape_2d(&self) -> (usize, usize)

Returns the first and second dimension shapes

fn shape_3d(&self) -> (usize, usize, usize)

Returns the first, second and third dimension shapes

fn shape_4d(&self) -> (usize, usize, usize, usize)

Returns the first, second, third and fourth dimension shapes

impl StructuralPartialEq for BooleanArrayV

impl TryFrom<Value> for BooleanArrayV

Available on crate feature views only.

fn try_from(v: Value) -> Result<Self, Self::Error>

Accepts any Value that resolves to an Array carrying a BooleanArray payload. The conversion routes through ArrayV, so an incoming view keeps its window instead of materialising it, and every input Array accepts is accepted here too.

type Error = MinarrowError

The type returned in the event of a conversion error.