Skip to main content

Cell

Struct Cell 

Source
pub struct Cell {
    pub ch: char,
    pub style: Style,
    pub width: u8,
}
Expand description

One character cell: a char, its Style, and its display width in terminal columns. The default cell is a single-width space in the default style.

width lets the grid model East Asian double-width glyphs and emoji, which occupy two columns:

  • 1 — a normal single-width cell (the common case, and the default).
  • 2 — the lead (left half) of a double-width glyph; ch holds the character. The cell immediately to its right should be a width-0 continuation.
  • 0 — a continuation (right half) of the glyph to its left: it carries no character of its own and is never emitted, because the terminal advances the cursor by two columns when it draws the lead glyph.

This crate does not compute width — that needs the Unicode database, which a zero-dependency crate cannot own. Callers set width (e.g. from the uwidth crate); the renderers here honor whatever width they are given.

Fields§

§ch: char§style: Style§width: u8

Implementations§

Source§

impl Cell

Source

pub const fn new(ch: char, style: Style) -> Self

A normal single-width cell (width == 1).

Source

pub const fn wide(ch: char, style: Style) -> Self

The lead (left half) of a double-width glyph (width == 2). Its right neighbor should be a Cell::continuation.

Source

pub const fn continuation(style: Style) -> Self

A continuation (right half) of a double-width glyph (width == 0): no character of its own, but carrying style so the covered column keeps the right background. Never emitted — the lead glyph fills both columns.

Trait Implementations§

Source§

impl Clone for Cell

Source§

fn clone(&self) -> Cell

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for Cell

Source§

impl Debug for Cell

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Cell

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Eq for Cell

Source§

impl PartialEq for Cell

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Cell

Auto Trait Implementations§

§

impl Freeze for Cell

§

impl RefUnwindSafe for Cell

§

impl Send for Cell

§

impl Sync for Cell

§

impl Unpin for Cell

§

impl UnsafeUnpin for Cell

§

impl UnwindSafe for Cell

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.