Struct IpcStreamReader

pub struct IpcStreamReader<R> { /* private fields */ }

Available on crate feature polars-io only.

Read Arrows Stream IPC format into a DataFrame

Example

use polars_core::prelude::*;
use std::fs::File;
use polars_io::ipc::IpcStreamReader;
use polars_io::SerReader;

fn example() -> PolarsResult<DataFrame> {
    let file = File::open("file.ipc").expect("file not found");

    IpcStreamReader::new(file)
        .finish()
}

Implementations

impl<R> IpcStreamReader<R>

where R: Read,

pub fn schema(&mut self) -> Result<Schema<DataType>, PolarsError>

Get schema of the Ipc Stream File

pub fn arrow_schema(&mut self) -> Result<Schema<Field>, PolarsError>

Get arrow schema of the Ipc Stream File, this is faster than creating a polars schema.

pub fn custom_metadata( &mut self, ) -> Result<Option<Arc<BTreeMap<PlSmallStr, PlSmallStr>>>, PolarsError>

Get schema-level custom metadata of the Ipc Stream file

pub fn with_n_rows(self, num_rows: Option<usize>) -> IpcStreamReader<R>

Stop reading when n rows are read.

pub fn with_columns(self, columns: Option<Vec<String>>) -> IpcStreamReader<R>

Columns to select/ project

pub fn with_row_index(self, row_index: Option<RowIndex>) -> IpcStreamReader<R>

Add a row index column.

pub fn with_projection( self, projection: Option<Vec<usize>>, ) -> IpcStreamReader<R>

Set the reader’s column projection. This counts from 0, meaning that vec![0, 4] would select the 1st and 5th column.

Trait Implementations

impl<R> SerReader<R> for IpcStreamReader<R>

where R: Read,

fn new(reader: R) -> IpcStreamReader<R>

Create a new instance of the SerReader

fn set_rechunk(self, rechunk: bool) -> IpcStreamReader<R>

Make sure that all columns are contiguous in memory by aggregating the chunks into a single array.

fn finish(self) -> Result<DataFrame, PolarsError>

Take the SerReader and return a parsed DataFrame.