Struct CursorManager 

pub struct CursorManager { /* private fields */ }

Manages cursor save/restore operations.

This struct handles the complexity of cursor save/restore across different strategies. It tracks the saved position for emulated mode and provides a unified interface regardless of the underlying mechanism.

Contract

• save() must be called before restore()
• Calling restore() without a prior save() is safe but may have no effect
• Multiple save() calls overwrite the previous save (no nesting)

Implementations

impl CursorManager

pub const fn new(strategy: CursorSaveStrategy) -> Self

Create a new cursor manager with the specified strategy.

pub fn detect(caps: &TerminalCapabilities) -> Self

Create a cursor manager with auto-detected strategy.

pub const fn strategy(&self) -> CursorSaveStrategy

Get the current strategy.

pub fn save<W: Write>( &mut self, writer: &mut W, current_pos: (u16, u16), ) -> Result<()>

Save the cursor position.

Arguments

• writer - The output writer (typically stdout)
• current_pos - Current cursor position (column, row), 0-indexed. Required for emulated mode, ignored for DEC/ANSI modes.

Errors

Returns an error if writing to the output fails.

pub fn restore<W: Write>(&self, writer: &mut W) -> Result<()>

Restore the cursor position.

Errors

Returns an error if writing to the output fails. For emulated mode, does nothing if no position was saved.

pub fn clear(&mut self)

Clear the saved position (for emulated mode).

This has no effect on DEC/ANSI modes.

pub const fn saved_position(&self) -> Option<(u16, u16)>

Get the saved position (for emulated mode).

Returns None for DEC/ANSI modes or if no position was saved.

Trait Implementations

impl Clone for CursorManager

fn clone(&self) -> CursorManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CursorManager

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

Formats the value using the given formatter.

impl Default for CursorManager

fn default() -> Self

Returns the “default value” for a type.