Struct tabled::settings::Concat

pub struct Concat { /* private fields */ }

Available on crate feature std only.

Concat concatenates tables along a particular axis [Horizontal | Vertical]. It doesn’t do any key or column comparisons like SQL’s join does.

When the tables has different sizes, empty cells will be created by default.

Concat in horizontal mode has similar behaviour to tuples (a, b). But it behaves on tables rather than on an actual data.

Concat DOES NOT handle style merge and other configuration of 2nd table, it just uses 1st one as a bases.

Example

use tabled::{Table, Tabled, settings::{Style, Concat}};

#[derive(Tabled)]
struct Message {
    id: &'static str,
    text: &'static str,
}

#[derive(Tabled)]
struct Department(#[tabled(rename = "department")] &'static str);

let messages = [
    Message { id: "0", text: "Hello World" },
    Message { id: "1", text: "Do do do something", },
];

let departments = [
    Department("Admins"),
    Department("DevOps"),
    Department("R&D"),
];

let mut table = Table::new(messages);
table
    .with(Concat::horizontal(Table::new(departments)))
    .with(Style::extended());

assert_eq!(
    table.to_string(),
    concat!(
        "╔════╦════════════════════╦════════════╗\n",
        "║ id ║ text               ║ department ║\n",
        "╠════╬════════════════════╬════════════╣\n",
        "║ 0  ║ Hello World        ║ Admins     ║\n",
        "╠════╬════════════════════╬════════════╣\n",
        "║ 1  ║ Do do do something ║ DevOps     ║\n",
        "╠════╬════════════════════╬════════════╣\n",
        "║    ║                    ║ R&D        ║\n",
        "╚════╩════════════════════╩════════════╝",
    )
)

Implementations

impl Concat

pub fn vertical(table: Table) -> Self

Concatenate 2 tables horizontally (along axis=0)

pub fn horizontal(table: Table) -> Self

Concatenate 2 tables vertically (along axis=1)

pub fn default_cell(self, cell: impl Into<Cow<'static, str>>) -> Self

Sets a cell’s content for cases where 2 tables has different sizes.

Trait Implementations

impl Debug for Concat

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

Formats the value using the given formatter.

impl<R, D, C> TableOption<R, C, D> for Concat

where R: Records + ExactRecords + Resizable + PeekableRecords + RecordsMut<String>,

fn change(self, records: &mut R, _: &mut C, _: &mut D)

The function modificaties of records and a grid configuration.

fn hint_change(&self) -> Option<Entity>

A hint whether an TableOption is going to change table layout.