Struct TextRef 

pub struct TextRef<'a> { /* private fields */ }

Read-only reference to a Text CRDT.

Text is a sequence CRDT optimized for collaborative text editing. For large documents, prefer slice() or chars() over content() to avoid allocating the entire string.

Implementations

impl<'a> TextRef<'a>

pub fn id(&self) -> CrdtId

Get the CRDT ID for this text.

pub fn content(&self) -> String

Get the full text content as a String.

For large documents, consider using slice() or chars() instead to avoid allocating the entire string.

pub fn slice(&self, range: Range<usize>) -> String

Get a slice of the text as a String.

Range is in Unicode characters (not bytes). This is more efficient than content() for extracting portions of large documents.

Example

use diamond_types_extended::{Document, Uuid};

let mut doc = Document::new();
let alice = doc.create_agent(Uuid::from_u128(0xA11CE));

doc.transact(alice, |tx| {
    let id = tx.root().create_text("content");
    tx.text_by_id(id).unwrap().insert(0, "Hello, world!");
});

let text = doc.root().get_text("content").unwrap();
assert_eq!(text.slice(0..5), "Hello");
assert_eq!(text.slice(7..12), "world");

pub fn chars(&self) -> impl Iterator<Item = char>

Iterate over characters in the text.

More memory-efficient than content() for large documents when you only need to iterate.

pub fn len(&self) -> usize

Get the length in Unicode characters.

pub fn is_empty(&self) -> bool

Check if the text is empty.