Struct Buffer 

pub struct Buffer {
    pub rope: Rope,
    pub path: Option<String>,
    pub dirty: bool,
    pub epoch: u64,
    pub readonly: bool,
    pub name: Option<String>,
    pub history: History,
    pub replaying: bool,
}

A text buffer. Positions are UTF-8 byte offsets, everywhere (0001 §5.1).

Fields

rope: Rope

path: Option<String>

dirty: bool

epoch: u64

Monotonic edit counter; async readers (git gutter) diff lazily.

readonly: bool

Read-only views (git surfaces): motions/yank work, edits refuse.

name: Option<String>

Display name for virtual buffers (statusline shows “[scratch]” otherwise): “git log”, “commit 1a2b3c”, …

history: History

Undo history (helix-style revision tree). Readonly buffers never record (their content is owned by jobs, not the user).

replaying: bool

Suppresses recording while applying undo/redo ops.

Implementations

impl Buffer

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

pub fn open(path: &str) -> Result<Self>

Open a file; a missing file is a new empty buffer with that path (vim semantics — :w creates it). Real I/O errors still error.

pub fn save(&mut self) -> Result<()>

pub fn len_bytes(&self) -> usize

pub fn len_lines(&self) -> usize

pub fn last_content_line(&self) -> usize

Last content line index — a trailing newline’s phantom empty line doesn’t count (vim’s G lands on real text).

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

Byte offset of the first char of line (0-indexed).

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

Byte offset one past the last content char of line (excludes \n).

pub fn line_of(&self, offset: usize) -> usize

pub fn col_of(&self, offset: usize) -> usize

Column (in bytes) of offset within its line.

pub fn byte(&self, offset: usize) -> u8

pub fn byte_at(&self, offset: usize) -> Option<u8>

pub fn clamp_boundary(&self, offset: usize) -> usize

Clamp a byte offset to a char boundary (prototype is ASCII-honest; the grapheme policy in 0001 §5.9 hardens this when text goes wide).

pub fn slice_string(&self, range: Range) -> String

Slice as String — for register/paste paths, never for per-frame render.

pub fn apply_history(&mut self, ops: Vec<Edit>)

Apply history edits (undo/redo replay — never recorded).

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

Replace the whole contents (virtual buffers filling from jobs).

pub fn delete(&mut self, range: Range) -> String

Returns the deleted text (register payoff).

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

pub fn line_text(&self, line: usize) -> String