Struct GraphemePool 

pub struct GraphemePool { /* private fields */ }

A reference-counted pool for complex grapheme clusters.

Stores multi-codepoint strings and returns compact GraphemeId references.

Implementations

impl GraphemePool

pub fn new() -> Self

Create a new empty grapheme pool.

pub fn with_capacity(capacity: usize) -> Self

Create a pool with pre-allocated capacity.

pub fn len(&self) -> usize

Number of active (non-free) slots.

pub fn is_empty(&self) -> bool

Check if the pool is empty.

pub fn capacity(&self) -> usize

Total capacity (including free slots).

pub fn intern(&mut self, text: &str, width: u8) -> GraphemeId

Intern a grapheme string and return its ID.

If the string is already interned, returns the existing ID and increments the reference count.

Parameters

• text: The grapheme cluster string
• width: Display width (0-127)

Panics

Panics if width > 127 or if the pool exceeds capacity (16M slots).

pub fn get(&self, id: GraphemeId) -> Option<&str>

Get the string for a grapheme ID.

Returns None if the ID is invalid or has been freed.

pub fn retain(&mut self, id: GraphemeId)

Increment the reference count for a grapheme.

Call this when a cell containing this grapheme is copied.

pub fn release(&mut self, id: GraphemeId)

Decrement the reference count for a grapheme.

Call this when a cell containing this grapheme is overwritten or freed. When the reference count reaches zero, the slot is freed for reuse.

pub fn refcount(&self, id: GraphemeId) -> u32

Get the reference count for a grapheme.

Returns 0 if the ID is invalid or freed.

pub fn clear(&mut self)

Clear all entries from the pool.

pub fn gc(&mut self, buffers: &[&Buffer])

Garbage collect graphemes not referenced by the given buffers.

This implements a Mark-and-Sweep algorithm:

1. Reset all internal refcounts to 0.
2. Scan provided buffers and increment refcounts for referenced graphemes.
3. Free any slots that remain with refcount 0.

This should be called periodically (e.g. every N frames) passing the current front and back buffers to prevent memory leaks in long-running apps.

Trait Implementations

impl Clone for GraphemePool

fn clone(&self) -> GraphemePool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphemePool

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

Formats the value using the given formatter.

impl Default for GraphemePool

fn default() -> Self

Returns the “default value” for a type.