Struct Row

Source

pub struct Row { /* private fields */ }

Expand description

Represent a table row made of cells

Implementations§

Source §

impl Row

Source

pub fn new(cells: Vec<Cell>) -> Row

Create a new Row backed with cells vector

Examples found in repository ?

examples/basic.rs (lines 25-29)

21fn main() {
22    let mut table = Table::new();
23    table.add_row(row!["ABC", "DEFG", "HIJKLMN"]);
24    table.add_row(row!["foobar", "bar", "foo"]);
25    table.add_row(Row::new(vec![
26        Cell::new("foobar2"),
27        Cell::new("bar2"),
28        Cell::new("foo2"),
29    ]));
30    table.printstd();
31    println!("Modified : ");
32    table.set_element("new_foo", 2, 1).unwrap();
33    table.printstd();
34
35    // The same table can be built the following way :
36    let _table = table!(
37        ["ABC", "DEFG", "HIJKLMN"],
38        ["foobar", "bar", "foo"],
39        ["foobar2", "bar2", "foo2"]
40    );
41
42    // Or directly print it like this
43    let _table = ptable!(
44        ["ABC", "DEFG", "HIJKLMN"],
45        ["foobar", "bar", "foo"],
46        ["foobar2", "bar2", "foo2"]
47    );
48}

More examples

Hide additional examples

examples/span.rs (lines 23-27)

3fn main() {
4    /*
5        The following code will output
6
7        +---------------+---------------+--------------+
8        |         A table with horizontal span         |
9        +===============+===============+==============+
10        | This is a cell with span of 2 | span of 1    |
11        +---------------+---------------+--------------+
12        | span of 1     | span of 1     | span of 1    |
13        +---------------+---------------+--------------+
14        |    This cell with a span of 3 is centered    |
15        +---------------+---------------+--------------+
16    */
17
18    let mut table: prettytable::Table = table![
19    [H2 -> "This is a cell with span of 2", "span of 1"],
20    ["span of 1", "span of 1", "span of 1"],
21    [H03c -> "This cell with a span of 3 is centered"]
22    ];
23    table.set_titles(Row::new(vec![Cell::new_align(
24        "A table with horizontal span",
25        Alignment::CENTER,
26    )
27    .with_hspan(3)]));
28    table.printstd();
29}

examples/style.rs (lines 13-21)

6fn main() {
7    let _ = table!();
8    let mut table = Table::new();
9    // Add style to a cell
10    table.add_row(row![FrByb->"ABC", "DEFG", "HIJKLMN"]);
11    // Add style to a full row
12    table.add_row(row![FY => "styled", "bar", "foo"]);
13    table.add_row(Row::new(vec![
14        Cell::new("foobar2"),
15        // Create a cell with a red foreground color
16        Cell::new("bar2").with_style(Attr::ForegroundColor(color::RED)),
17        // Create a cell with red foreground color, yellow background color, with bold characters
18        Cell::new("foo2").style_spec("FrByb"),
19        // Using the cell! macro
20        cell!(Fr->"red"),
21    ]));
22
23    table.printstd();
24
25    // Print a table with some styles on it :
26    // FrBybl means : Foregound red, Background yellow, bold, left align
27    ptable!([FrBybl->"A", "B", FrBybr->"C"], [123, 234, 345, 456], [Fg => 1, 2, 3]);
28
29    // You can also apply style to full rows :
30    let mut table = table!([Frb => "A", "B", "C"], [1, 2, 3, 4], ["A\nBCCZZZ\nDDD", 2, table]);
31    // Set a title line, with all text centered in the cell
32    table.set_titles(row![c => "Title 1", "Title 2"]);
33    table.printstd();
34}

Source

pub fn empty() -> Row

Create an row of length size, with empty strings stored

Source

pub fn len(&self) -> usize

Get the number of cells in this row

Source

pub fn is_empty(&self) -> bool

Check if the row is empty (has no cell)

Source

pub fn get_cell(&self, idx: usize) -> Option<&Cell>

Get the cell at index idx

Examples found in repository ?

examples/tictactoe.rs (line 45)

11fn main() {
12    let mut table = table![
13        [EMPTY, EMPTY, EMPTY],
14        [EMPTY, EMPTY, EMPTY],
15        [EMPTY, EMPTY, EMPTY]
16    ];
17    let mut height = table.print_tty(false).unwrap();
18    let stdin = io::stdin();
19    let mut stdout = io::stdout();
20    let mut current = CROSS;
21    let mut terminal = term::stdout().unwrap();
22    loop {
23        let mut line = String::new();
24        print!("{} plays > ", current);
25        height += 1;
26        stdout.flush().unwrap();
27        stdin.read_line(&mut line).expect("Cannot read input");
28        let i = match usize::from_str(line.trim()) {
29            Ok(i) => i,
30            _ => {
31                println!("Bad input");
32                height += 1;
33                continue;
34            }
35        };
36        if i < 1 || i > 9 {
37            println!("Bad input, should be between 1 and 9");
38            height += 1;
39            continue;
40        }
41        let x = (i - 1) % 3;
42        let y = (i - 1) / 3;
43        {
44            let row = table.get_mut_row(y).unwrap();
45            if row.get_cell(x).unwrap().to_string() != EMPTY {
46                println!("There's already someone there");
47                height += 1;
48                continue;
49            }
50            row.set_cell(cell!(current), x).unwrap();
51        }
52        for _ in 0..height {
53            terminal.cursor_up().unwrap();
54            terminal.delete_line().unwrap();
55        }
56        height = table.print_tty(false).unwrap();
57        if check(&table) {
58            return;
59        }
60        if current == CROSS {
61            current = ROUND;
62        } else {
63            current = CROSS;
64        }
65    }
66}
67
68fn get(table: &Table, x: usize, y: usize) -> String {
69    match table.get_row(y) {
70        Some(r) => match r.get_cell(x) {
71            Some(c) => c.to_string(),
72            _ => EMPTY.to_string(),
73        },
74        _ => EMPTY.to_string(),
75    }
76}

Source

pub fn get_mut_cell(&mut self, idx: usize) -> Option<&mut Cell>

Get the mutable cell at index idx

Source

pub fn set_cell(&mut self, cell: Cell, idx: usize) -> Result<(), &str>

Set the cell in the row at the given idx index

Examples found in repository ?

examples/tictactoe.rs (line 50)

11fn main() {
12    let mut table = table![
13        [EMPTY, EMPTY, EMPTY],
14        [EMPTY, EMPTY, EMPTY],
15        [EMPTY, EMPTY, EMPTY]
16    ];
17    let mut height = table.print_tty(false).unwrap();
18    let stdin = io::stdin();
19    let mut stdout = io::stdout();
20    let mut current = CROSS;
21    let mut terminal = term::stdout().unwrap();
22    loop {
23        let mut line = String::new();
24        print!("{} plays > ", current);
25        height += 1;
26        stdout.flush().unwrap();
27        stdin.read_line(&mut line).expect("Cannot read input");
28        let i = match usize::from_str(line.trim()) {
29            Ok(i) => i,
30            _ => {
31                println!("Bad input");
32                height += 1;
33                continue;
34            }
35        };
36        if i < 1 || i > 9 {
37            println!("Bad input, should be between 1 and 9");
38            height += 1;
39            continue;
40        }
41        let x = (i - 1) % 3;
42        let y = (i - 1) / 3;
43        {
44            let row = table.get_mut_row(y).unwrap();
45            if row.get_cell(x).unwrap().to_string() != EMPTY {
46                println!("There's already someone there");
47                height += 1;
48                continue;
49            }
50            row.set_cell(cell!(current), x).unwrap();
51        }
52        for _ in 0..height {
53            terminal.cursor_up().unwrap();
54            terminal.delete_line().unwrap();
55        }
56        height = table.print_tty(false).unwrap();
57        if check(&table) {
58            return;
59        }
60        if current == CROSS {
61            current = ROUND;
62        } else {
63            current = CROSS;
64        }
65    }
66}