Struct Snapshot 

pub struct Snapshot { /* private fields */ }

An immutable, Send + Sync copy of the document for background consumers (e.g. a debounced compile thread).

Creation is O(1) — a rope clone shares structure. The consumer pays for what it reads: Snapshot::text is an O(len) materialization that now runs on the consumer’s thread, not the UI thread; the ranged reads mirror Buffer’s backing-agnostic API.

Implementations

impl Snapshot

pub fn len(&self) -> u32

Total byte length of the snapshot.

pub fn is_empty(&self) -> bool

Whether the snapshot is empty (a single empty line — never truly zero).

pub fn text(&self) -> Cow<'_, str>

The whole snapshot text, LF-only. Borrowed for single-chunk (small) documents; an O(len) materialization otherwise — run it on the consumer’s thread.

pub fn slice(&self, range: Range<u32>) -> Cow<'_, str>

The text in range (byte offsets on char boundaries). Clamps to the snapshot end.

pub fn line(&self, row: u32) -> Cow<'_, str>

The text of one row, excluding its trailing \n. Out-of-range rows return "".

pub fn line_count(&self) -> u32

Number of lines. Always ≥ 1; a trailing \n yields a final empty line.

pub fn doc_id(&self) -> DocId

The document this snapshot came from.

pub fn revision(&self) -> Revision

The revision this snapshot froze.

Trait Implementations

impl Clone for Snapshot

fn clone(&self) -> Snapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Snapshot

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

Formats the value using the given formatter.