Struct TextBuffer 

pub struct TextBuffer { /* private fields */ }

A text buffer backed by a ropey::Rope.

Every mutating operation increments an internal revision counter so that downstream systems (layout caches, syntax highlights, diagnostics, etc.) can cheaply detect stale data.

Implementations

impl TextBuffer

pub fn new() -> Self

Create an empty buffer.

pub fn from_str(text: &str) -> Self

Create a buffer pre-populated with text.

impl TextBuffer

pub fn text(&self) -> &Rope

Return a reference to the underlying rope.

pub fn len_bytes(&self) -> usize

Total length in bytes (UTF-8).

pub fn len_chars(&self) -> usize

Total length in Unicode characters (grapheme-unaware; counts chars).

pub fn len_lines(&self) -> usize

Number of lines. A trailing \n implies an additional empty final line, matching the convention used by most editors.

pub fn line(&self, line_idx: usize) -> RopeSlice<'_>

Return the contents of line_idx (0-based) as a ropey::RopeSlice, including the line terminator if present.

Panics

Panics if line_idx >= self.len_lines().

pub fn slice(&self, byte_range: Range<usize>) -> RopeSlice<'_>

Return an arbitrary byte-offset range as a RopeSlice.

Both bounds are byte offsets and must lie on char boundaries.

Panics

Panics if the range is out of bounds or not on char boundaries.

pub fn revision(&self) -> u64

Monotonically increasing revision counter. Incremented on every mutation (insert, delete, replace).

pub fn is_empty(&self) -> bool

true when the buffer contains no characters.

impl TextBuffer

pub fn insert(&mut self, byte_offset: usize, text: &str)

Insert text at the given byte offset.

Panics

Panics if byte_offset is out of bounds or not on a char boundary.

pub fn delete(&mut self, byte_range: Range<usize>)

Delete the byte range start..end.

Panics

Panics if the range is out of bounds or not on char boundaries.

pub fn replace(&mut self, byte_range: Range<usize>, text: &str)

Replace the byte range start..end with text.

Equivalent to a delete followed by an insert but only bumps the revision once.

Trait Implementations

impl Clone for TextBuffer

fn clone(&self) -> TextBuffer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextBuffer

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

Formats the value using the given formatter.

impl Default for TextBuffer

fn default() -> Self

Returns the “default value” for a type.

impl Display for TextBuffer

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

Formats the value using the given formatter.