Struct DataChunk 

pub struct DataChunk(/* private fields */);

An owned DuckDB duckdb_data_chunk — a batch of column vectors — that is destroyed on drop.

Obtain one from a query result with DataChunk::from_result, then append it elsewhere with Appender::append_chunk.

Implementations

impl DataChunk

pub fn new(data_chunk: duckdb_data_chunk) -> Result<DataChunk>

Takes ownership of a raw duckdb_data_chunk handle.

Errors

Returns an error if data_chunk is null.

pub fn from_result(result: &DuckResult) -> Option<Result<DataChunk>>

Fetches the next chunk of a query result, or None once the result is exhausted.

pub fn current_row(&self) -> u64

The current row cursor used by next_row.

pub fn row_count(&self) -> u64

The number of rows in the chunk.

pub fn reset(&mut self)

Resets the chunk to empty (row count 0), keeping its allocated capacity so it can be refilled and re-appended.

pub fn next_row(&mut self) -> Option<u64>

Advances the row cursor, returning the next row index, or None at the end (destroying the underlying chunk).

Trait Implementations

impl Deref for DataChunk

type Target = *mut _duckdb_data_chunk

The resulting type after dereferencing.

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

Dereferences the value.

impl DerefMut for DataChunk

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Drop for DataChunk

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.