Struct Glyph 

pub struct Glyph(/* private fields */);

What a cell renders to: one extended grapheme cluster, never a control character.

A grapheme cluster is the unit UAX #29 draws a boundary around — what a reader sees as one character, which may be built from several code points: é written as e followed by a combining acute, a flag, or an emoji with a modifier. A control character is one in Unicode’s Cc category — what char::is_control answers — and the refusal holds even inside an otherwise-accepted cluster: "\r\n" is one cluster by UAX #29 and is refused anyway.

Width is not part of this invariant: a grapheme wider than one column is accepted and shifts the rest of its row by a column, and a cluster made only of format characters is accepted and occupies no column. Equality is by text, not by appearance: two glyphs that render alike but are encoded differently compare unequal, because nothing here is normalized.

Implementations

impl Glyph

pub fn new(text: &str) -> Option<Self>

Some when text is exactly one extended grapheme cluster containing no control character, None otherwise.

pub fn as_str(&self) -> &str

The glyph’s text.

Trait Implementations

impl Clone for Glyph

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Glyph

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

Formats the value using the given formatter.

impl Eq for Glyph

impl PartialEq for Glyph

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Glyph