Struct Column

pub struct Column {
    pub index: usize,
    /* private fields */
}

A representation of a table’s column. Useful for styling and specifying constraints how big a column should be.

1. Content padding for cells in this column
2. Constraints on how wide this column shall be
3. Default alignment for cells in this column

Columns are generated when adding rows or a header to a table.
As a result columns can only be modified after the table is populated by some data.

use comfy_table::{Width::*, CellAlignment, ColumnConstraint::*, Table};

let mut table = Table::new();
table.set_header(&vec!["one", "two"]);

let mut column = table.column_mut(1).expect("This should be column two");

// Set the max width for all cells of this column to 20 characters.
column.set_constraint(UpperBoundary(Fixed(20)));

// Set the left padding to 5 spaces and the right padding to 1 space
column.set_padding((5, 1));

// Align content in all cells of this column to the center of the cell.
column.set_cell_alignment(CellAlignment::Center);

Fields

index: usize

The index of the column

Implementations

impl Column

pub fn new(index: usize) -> Self

pub fn set_padding(&mut self, padding: (u16, u16)) -> &mut Self

Set the padding for all cells of this column.

Padding is provided in the form of (left, right).
Default is (1, 1).

pub fn padding_width(&self) -> u16

Convenience helper that returns the total width of the combined padding.

pub fn set_delimiter(&mut self, delimiter: char) -> &mut Self

Set the delimiter used to split text for this column’s cells.

A custom delimiter on a cell in will overwrite the column’s delimiter. Normal text uses spaces ( ) as delimiters. This is necessary to help comfy-table understand the concept of words.

pub fn set_constraint(&mut self, constraint: ColumnConstraint) -> &mut Self

Constraints allow to influence the auto-adjustment behavior of columns.
This can be useful to counter undesired auto-adjustment of content in tables.

pub fn constraint(&self) -> Option<&ColumnConstraint>

Get the constraint that is used for this column.

pub fn remove_constraint(&mut self) -> &mut Self

Remove any constraint on this column

pub fn is_hidden(&self) -> bool

Returns weather the columns is hidden via ColumnConstraint::Hidden.

pub fn set_cell_alignment(&mut self, alignment: CellAlignment)

Set the alignment for content inside of cells for this column.
Note: Alignment on a cell will always overwrite the column’s setting.

Trait Implementations

impl Clone for Column

fn clone(&self) -> Column

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Column

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

Formats the value using the given formatter.