Struct Rows 

pub struct Rows { /* private fields */ }

Rows held in memory: column names, an optional schema, and the rows.

Implementations

impl Rows

pub fn new(columns: impl IntoIterator<Item = impl Into<String>>) -> Self

No rows under columns.

pub fn with_schema(self, schema: Schema) -> Self

Attach a schema (one field per column).

pub fn set_schema(&mut self, schema: Option<Schema>)

Replace the schema.

pub fn push(&mut self, row: impl IntoIterator<Item = Value>) -> &mut Self

Append a row: missing cells are null, and extra cells are dropped.

pub fn columns(&self) -> &[String]

The column names.

pub fn schema(&self) -> Option<&Schema>

The schema, if any.

pub fn rows(&self) -> &[Row]

The rows, in order.

pub fn rows_mut(&mut self) -> &mut [Row]

The rows, to change in place. Keep one cell per column.

pub fn len(&self) -> usize

The number of rows.

pub fn is_empty(&self) -> bool

Whether there are no rows.

pub fn column_index(&self, name: &str) -> Option<usize>

The position of the first column called name.

pub fn column(&self, index: usize) -> impl Iterator<Item = &Value>

Every cell of the column at index, top to bottom.

pub fn into_parts(self) -> (Vec<String>, Option<Schema>, Vec<Row>)

The columns, schema and rows.

pub fn into_source(self) -> RowsSource

A row source over these rows.

pub fn to_table_data(&self) -> TableData

A table of these rows: one column per name, numeric columns (by the schema) right-justified. Sort, group, total or style it with rich_ext::table.

Trait Implementations

impl Clone for Rows

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Rows

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

Formats the value using the given formatter.

impl Default for Rows

fn default() -> Self

Returns the “default value” for a type.

impl VirtualRows for Rows

fn row_count(&self) -> Option<usize>

How many rows there are, when the source knows.

fn row(&self, index: usize) -> Option<Vec<Value>>

The row at index (0-based), or None past the end.

fn rows(&self, start: usize, len: usize) -> Vec<Vec<Value>>

Up to len rows from start, fewer at the end. The default calls row until it returns None.

fn rows_columns( &self, start: usize, len: usize, columns: &[usize], ) -> Vec<Vec<Value>>

Up to len rows from start, each with only the cells of columns (0-based, in that order; a cell past the row’s end is null): what a column window of a wide table fetches. The default calls rows and picks the cells; a source that can read some columns without the rest (a columnar file, a query, cells computed on demand such as FnCells) overrides it.