Struct Table 

pub struct Table<Row = TextTableRow> { /* private fields */ }

Owned table data independent of presentation policy.

Table owns semantic content, structural visibility, and offsets only. Every presentation concern — borders, padding, width, and cell styles — belongs to TablePresentation.

Rows may be ragged: a row shorter than the widest row is padded with empty cells when its TableRow formatting is composed. Use Table::text for rows that are already plain text.

use urushi::{BlockStyle, Table, TablePresentation, TextStyle, measure};

let table = Table::text()
    .headers(["Name", "Location"])
    .row(["Kini", "New York"])
    .row(["Iris", "Paris"]);

let presentation =
    TablePresentation::new(BlockStyle::new(), BlockStyle::new(), TextStyle::new());
assert_eq!(measure(&presentation.compose(&table)).height(), 6);

Implementations

impl<Row> Table<Row>

pub fn new() -> Self

Creates an empty table.

pub fn headers<I, S>(self, headers: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Replaces the header cells, each of which is plain text.

A table without headers composes its body rows only. Escape sequences and cursor movement in a header break the plain-text contract: debug builds panic, and release builds measure them as ordinary characters and may split them when wrapping or truncating. Raw ANSI is not accepted as component text.

pub fn row(self, row: Row) -> Self

Appends one body row.

pub fn rows<I>(self, rows: I) -> Self

where I: IntoIterator<Item = Row>,

Appends typed body rows in iteration order.

pub const fn hidden(self, hidden: bool) -> Self

Includes or excludes the complete table.

pub const fn offset(self, start: usize, end: usize) -> Self

Omits start body rows from the front and end from the back.

Headers are never omitted; the offset selects among body rows only.

pub const fn is_hidden(&self) -> bool

Returns whether the table is excluded.

impl<Row> Table<Row>

where Row: TableRow,

pub fn column_count(&self) -> usize

Returns the column count from the widest canonical header or body row.

This formats every owned row, including rows omitted by the offset. Composition formats only visible rows, so an omitted wide row does not add columns to the composed view.

impl Table<TextTableRow>

pub fn text() -> TextTable

Creates an empty table that accepts rows of direct plain text.

Trait Implementations

impl<Row: Clone> Clone for Table<Row>

fn clone(&self) -> Table<Row>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Row: Debug> Debug for Table<Row>

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

Formats the value using the given formatter.

impl<Row> Default for Table<Row>

fn default() -> Self

Returns the “default value” for a type.

impl<Row: PartialEq> PartialEq for Table<Row>

fn eq(&self, other: &Table<Row>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<Row: Eq> Eq for Table<Row>

impl<Row> StructuralPartialEq for Table<Row>