Struct unsegen::base::cursor::CursorRestorer

#[must_use]pub struct CursorRestorer<'a, 'c: 'a, 'g: 'c, T: 'c + CursorTarget> { /* fields omitted */ }

Guard value used to restore desired state to a cursor at the end of the scope. Created using Cursor::save.

Implementations

impl<'a, 'c: 'a, 'g: 'c, T: 'c + CursorTarget> CursorRestorer<'a, 'c, 'g, T>

pub fn style_modifier(self) -> Self

Save the current style modifier of the underlying cursor and restore it when this struct is dropped.

pub fn line_start_column(self) -> Self

Save the current line start column of the underlying cursor and restore it when this struct is dropped.

pub fn col(self) -> Self

Save the current column position of the underlying cursor and restore it when this struct is dropped.

pub fn row(self) -> Self

Save the current row position of the underlying cursor and restore it when this struct is dropped.

Methods from Deref<Target = Cursor<'c, 'g, T>>

pub fn get_position(&self) -> (ColIndex, RowIndex)

pub fn get_col(&self) -> ColIndex

pub fn get_row(&self) -> RowIndex

pub fn move_by(&mut self, x: ColDiff, y: RowDiff)

Move the cursor by the specifed amount in x- and y-direction.

Examples:

use unsegen::base::*;

let mut w = ExtentEstimationWindow::with_width(Width::new(20).unwrap());
let mut cursor = Cursor::new(&mut w).position(ColIndex::new(27), RowIndex::new(37));

cursor.move_by(ColDiff::new(10), RowDiff::new(-10));

assert_eq!(cursor.get_col(), ColIndex::new(37));
assert_eq!(cursor.get_row(), RowIndex::new(27));

pub fn move_to(&mut self, x: ColIndex, y: RowIndex)

pub fn move_to_x(&mut self, x: ColIndex)

pub fn move_to_y(&mut self, y: RowIndex)

pub fn move_left(&mut self)

Move left, but skip empty clusters, also wrap to the line above if wrapping is active

pub fn move_right(&mut self)

Move right, but skip empty clusters, also wrap to the line below if wrapping is active

pub fn set_wrapping_mode(&mut self, wm: WrappingMode)

pub fn set_line_start_column(&mut self, column: ColIndex)

pub fn move_line_start_column(&mut self, d: ColDiff)

Move the start column by the specified amount.

pub fn set_style_modifier(&mut self, style_modifier: StyleModifier)

pub fn get_style_modifier(&mut self) -> StyleModifier

pub fn apply_style_modifier(&mut self, style_modifier: StyleModifier)

Apply the specified modifier on_top of the current modifier.

pub fn set_tab_column_width(&mut self, width: Width)

Set how far a tab character ('\t') will move the cursor to the right.

pub fn backspace(&mut self)

Emulate a "backspace" action, i.e., move the cursor one character to the left and replace the character under the cursor with a space.

pub fn clear_line_left(&mut self)

Clear all character to the left of the cursor in the current line including the cursor position itself.

pub fn clear_line_right(&mut self)

Clear all character to the right of the cursor in the current line including the cursor position itself.

pub fn clear_line(&mut self)

Clear all characters in the current line.

pub fn fill_and_wrap_line(&mut self)

Fill the remainder of the line with spaces and wrap to the beginning of the next line.

pub fn wrap_line(&mut self)

Wrap to the beginning of the current line.

pub fn carriage_return(&mut self)

Move the cursor to the beginning of the current line (but do not change the row position).

pub fn num_expected_wraps(&self, line: &str) -> usize

Calculate the number of wraps that are expected when writing the given text to the terminal, but do not write the text itself.

pub fn get_current_cell_mut(&mut self) -> Option<&mut StyledGraphemeCluster>

(Mutably) get the cell under the current cursor position.

pub fn get_current_cell(&self) -> Option<&StyledGraphemeCluster>

Get the cell under the current cursor position.

pub fn write_preformatted(&mut self, clusters: &[StyledGraphemeCluster])

Write a preformatted slice of styled grapheme clusters to the target at the current cursor position.

Be very careful when using this function. Although safety is guaranteed, the program can easily panic when using this function in any wrong way.

A safe way to obtain a valid argument for this function would be to implement a CursorTarget with a Vec as a backing store and write to that target using a cursor. Any slice whose endpoints are defined by cursor positions which occured while writing to this target is valid.

Panics

Panics if the number of clusters does not equals its total width

pub fn write(&mut self, text: &str)

Write a string to the target at the current cursor position.

pub fn writeln(&mut self, text: &str)

pub fn save<'a>(&'a mut self) -> CursorRestorer<'a, 'c, 'g, T>

Save the current state of the cursor. The current state will be restored when the returned CursorRestorer is dropped.

Examples:

use unsegen::base::*;

let mut w = ExtentEstimationWindow::with_width(Width::new(20).unwrap());
let mut cursor = Cursor::new(&mut w)
    .position(ColIndex::new(0), RowIndex::new(0));

let old_style = cursor.get_style_modifier();
{
    let mut cursor = cursor.save().col().style_modifier();
    cursor.apply_style_modifier(StyleModifier::new().bold(BoolModifyMode::Toggle));
    cursor.write("testing, testing, oioioi!");
}
assert_eq!(cursor.get_col(), ColIndex::new(0));
assert_eq!(cursor.get_style_modifier(), old_style);

Trait Implementations

impl<'a, 'c: 'a, 'g: 'c, T: 'c + CursorTarget> Deref for CursorRestorer<'a, 'c, 'g, T>

type Target = Cursor<'c, 'g, T>

The resulting type after dereferencing.

fn deref(&self) -> &Cursor<'c, 'g, T>

Dereferences the value.

impl<'a, 'c: 'a, 'g: 'c, T: 'c + CursorTarget> DerefMut for CursorRestorer<'a, 'c, 'g, T>

fn deref_mut(&mut self) -> &mut Cursor<'c, 'g, T>

Mutably dereferences the value.

impl<'a, 'c: 'a, 'g: 'c, T: 'c + CursorTarget> Drop for CursorRestorer<'a, 'c, 'g, T>

fn drop(&mut self)

Executes the destructor for this type.