Struct Cell 

#[repr(C, align(16))]
pub struct Cell {
    pub content: CellContent,
    pub fg: PackedRgba,
    pub bg: PackedRgba,
    pub attrs: CellAttrs,
}

A single terminal cell (16 bytes).

Layout

#[repr(C, align(16))]
Cell {
    content: CellContent,  // 4 bytes
    fg: PackedRgba,        // 4 bytes
    bg: PackedRgba,        // 4 bytes
    attrs: CellAttrs,      // 4 bytes
}

Invariants

• Size is exactly 16 bytes (verified by compile-time assert)
• All fields are valid (no uninitialized memory)
• Continuation cells should not have meaningful fg/bg (they inherit from parent)

Default

The default cell is empty with transparent background, white foreground, and no style attributes.

Fields

content: CellContent

Character or grapheme content.

fg: PackedRgba

Foreground color.

bg: PackedRgba

Background color.

attrs: CellAttrs

Style flags and hyperlink ID.

Implementations

impl Cell

pub const CONTINUATION: Cell

A continuation cell (placeholder for wide characters).

When a character has display width > 1, subsequent cells are filled with this to indicate they are “owned” by the previous cell.

pub const fn new(content: CellContent) -> Cell

Create a new cell with the given content and default colors.

pub const fn from_char(c: char) -> Cell

Create a cell from a single character.

pub const fn is_continuation(&self) -> bool

Check if this is a continuation cell.

pub const fn is_empty(&self) -> bool

Check if this cell is empty.

pub const fn width_hint(&self) -> usize

Get the display width hint for this cell.

See CellContent::width_hint for details.

pub fn bits_eq(&self, other: &Cell) -> bool

Bitwise equality comparison (fast path for diffing).

Uses bitwise AND (&) instead of short-circuit AND (&&) so all four u32 comparisons are always evaluated. This avoids branch mispredictions in tight loops and allows LLVM to lower the check to a single 128-bit SIMD compare on supported targets.

pub const fn with_char(self, c: char) -> Cell

Set the cell content to a character, preserving other fields.

pub const fn with_fg(self, fg: PackedRgba) -> Cell

Set the foreground color.

pub const fn with_bg(self, bg: PackedRgba) -> Cell

Set the background color.

pub const fn with_attrs(self, attrs: CellAttrs) -> Cell

Set the style attributes.

Trait Implementations

impl Clone for Cell

fn clone(&self) -> Cell

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cell

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

Formats the value using the given formatter.

impl Default for Cell

fn default() -> Cell

Returns the “default value” for a type.

impl PartialEq for Cell

fn eq(&self, other: &Cell) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Cell

impl Eq for Cell

impl StructuralPartialEq for Cell