Struct crossterm::Terminal

pub struct Terminal { /* fields omitted */ }

Allows you to preform actions on the terminal.

Features:

• Clearing (all lines, current line, from cursor down and up, until new line)
• Scrolling (Up, down)
• Get the size of the terminal
• Set the size of the terminal
• Alternate screen
• Raw screen
• Exit the current process

Check /examples/ in the library for more specific examples.

Methods

impl Terminal

pub fn new() -> Terminal

Create new terminal instance whereon terminal related actions can be performed.

pub fn clear(&self, clear_type: ClearType) -> Result<(), ErrorKind>

Clear the current cursor by specifying the ClearType.

Example

let mut term = terminal();

// clear all cells in terminal.
term.clear(terminal::ClearType::All);
// clear all cells from the cursor position downwards in terminal.
term.clear(terminal::ClearType::FromCursorDown);
// clear all cells from the cursor position upwards in terminal.
term.clear(terminal::ClearType::FromCursorUp);
// clear current line cells in terminal.
term.clear(terminal::ClearType::CurrentLine);
// clear all cells from cursor position until new line in terminal.
term.clear(terminal::ClearType::UntilNewLine);

pub fn terminal_size(&self) -> (u16, u16)

Get the terminal size (x,y).

Remark

This will return a tuple of (x: u16, y: u16)

pub fn scroll_up(&self, count: i16) -> Result<(), ErrorKind>

Scroll n lines up in the current terminal.

Parameter

• count: the number of rows should be shifted up.

pub fn scroll_down(&self, count: i16) -> Result<(), ErrorKind>

Scroll n lines down in the current terminal.

Parameter

• count: the number of rows should be shifted down.

pub fn set_size(&self, width: i16, height: i16) -> Result<(), ErrorKind>

Set the terminal size. Note that not all terminals can be set to a very small scale.

let mut term = terminal();

// Set of the size to X: 10 and Y: 10
let size = term.set_size(10,10);

pub fn exit(&self)

Exit the current process.

let mut term = terminal();

let size = term.exit();

pub fn write<D>(&self, value: D) -> Result<usize, ErrorKind> where
    D: Display, 

Write any displayable content to the current terminal screen.

let mut term = terminal();

let size = term.write("Some text \n Some text on new line");

This will also flush the standard output.