Struct RopeBuffer 

pub struct RopeBuffer { /* private fields */ }

A rope-based line buffer for efficient large document storage.

Instead of storing each line as a separate allocation, lines are grouped into chunks of CHUNK_SIZE lines. This reduces:

• Memory fragmentation
• Allocation overhead
• Cache misses during iteration

Implementations

impl RopeBuffer

pub fn new(max_lines: usize) -> Self

Create a new rope buffer with the given maximum capacity.

Arguments

• max_lines - Maximum lines to retain. 0 means unlimited.

pub fn unbounded() -> Self

Create an unbounded rope buffer.

pub const fn len(&self) -> usize

Get the total number of lines.

pub const fn is_empty(&self) -> bool

Check if the buffer is empty.

pub const fn chunk_count(&self) -> usize

Get the number of chunks.

pub fn get_line(&self, index: usize) -> Option<&ChunkedLine>

Get a line by global index.

pub fn get_line_mut(&mut self, index: usize) -> Option<&mut ChunkedLine>

Get a mutable reference to a line by global index.

pub fn current_line(&self) -> Option<&ChunkedLine>

Get the current (last) line.

pub fn current_line_mut(&mut self) -> Option<&mut ChunkedLine>

Get a mutable reference to the current (last) line.

pub fn push_line(&mut self, line: ChunkedLine)

Push a new line to the buffer.

pub fn newline(&mut self)

Add a new empty line.

pub fn append(&mut self, cells: impl Iterator<Item = Cell>)

Append cells to the current line.

pub fn clear(&mut self)

Clear all content.

pub const fn scroll_offset(&self) -> usize

Get the current scroll offset.

pub fn scroll_up(&mut self, lines: usize)

Scroll up by the given number of lines.

pub const fn scroll_down(&mut self, lines: usize)

Scroll down by the given number of lines.

pub const fn scroll_to_bottom(&mut self)

Scroll to the bottom (most recent content).

pub fn visible_lines( &self, viewport_height: usize, ) -> impl Iterator<Item = (usize, &ChunkedLine)>

Iterate over lines in the visible range.

Returns an iterator over (line_index, &ChunkedLine) for lines that should be visible given the viewport height.

pub fn memory_stats(&self) -> RopeMemoryStats

Get memory usage statistics.

Trait Implementations

impl Debug for RopeBuffer

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

Formats the value using the given formatter.