Struct FlatVector 

pub struct FlatVector<'a> { /* private fields */ }

A flat (contiguous, scalar-row) vector borrowed from a DataChunkHandle.

Implementations

impl<'a> FlatVector<'a>

pub fn capacity(&self) -> usize

Returns the capacity of the vector

pub fn row_is_null(&self, row: u64) -> bool

Returns true if the row at the given index is null

Panics

Panics if row is outside the vector capacity.

pub fn try_row_is_null(&self, row: u64) -> Result<bool>

Returns whether the row is null, or an error if it is out of range.

pub unsafe fn as_mut_ptr<T>(&self) -> *mut T

Returns a mutable pointer to the vector’s backing data cast to T.

Safety

The caller must ensure T matches the DuckDB vector’s physical storage. Before dereferencing the pointer, the caller must also ensure the target element is initialized, in bounds, and not accessed through another incompatible or aliased reference.

pub unsafe fn as_slice<T>(&self) -> &[T]

Returns a typed slice of the vector.

Safety

The caller must ensure T matches the DuckDB vector’s physical storage, the backing allocation is sized for self.capacity() elements of T, each returned element is initialized before it is read, and no &mut references to the same storage exist for the returned lifetime.

pub unsafe fn as_slice_with_len<T>(&self, len: usize) -> &[T]

Returns a typed slice of the vector up to a certain length.

Safety

The caller must ensure T matches the DuckDB vector’s physical storage, the backing allocation is sized for at least len elements of T, each returned element is initialized before it is read, and no &mut references to the same storage exist for the returned lifetime.

pub unsafe fn as_mut_slice<T>(&mut self) -> &mut [T]

Returns a typed mutable slice of the vector.

Safety

The caller must ensure T matches the DuckDB vector’s physical storage, the backing allocation is sized for self.capacity() elements of T, and no other references to the same storage exist for the returned lifetime.

pub unsafe fn as_mut_slice_with_len<T>(&mut self, len: usize) -> &mut [T]

Returns a typed mutable slice of the vector up to a certain length.

Safety

The caller must ensure T matches the DuckDB vector’s physical storage, the backing allocation is sized for at least len elements of T, and no other references to the same storage exist for the returned lifetime.

pub fn logical_type(&self) -> LogicalTypeHandle

Returns the logical type of the vector

pub fn set_null(&mut self, row: usize)

Set row as null

pub unsafe fn copy<T: Copy>(&mut self, data: &[T])

Copy typed data to the vector.

Safety

The caller must ensure T matches the DuckDB vector’s physical storage and no other references to the same storage exist during the copy.

Panics

Panics if data.len() exceeds the vector capacity.

Trait Implementations

impl Inserter<&String> for FlatVector<'_>

fn insert(&self, index: usize, value: &String)

Insert a value into the vector.

impl Inserter<&Vec<u8>> for FlatVector<'_>

fn insert(&self, index: usize, value: &Vec<u8>)

Insert a value into the vector.

impl Inserter<&[u8]> for FlatVector<'_>

fn insert(&self, index: usize, value: &[u8])

Insert a value into the vector.

impl Inserter<&str> for FlatVector<'_>

fn insert(&self, index: usize, value: &str)

Insert a value into the vector.

impl Inserter<CString> for FlatVector<'_>

fn insert(&self, index: usize, value: CString)

Insert a value into the vector.