Struct TextSpans 

pub struct TextSpans { /* private fields */ }

An encoded list of spans, ready to travel.

Shared rather than copied, for the same reason a draw list is: the same list redrawn every frame compares equal and produces no mutation at all.

Implementations

impl TextSpans

pub fn new(spans: impl IntoIterator<Item = TextSpan>) -> Self

pub fn new_with_fonts( spans: impl IntoIterator<Item = (TextSpan, FontRefs)>, ) -> Self

Runs, each with the fonts it is set in where the text has no role.

An empty list leaves that run in the text’s own font. A run of text that has a role is always in the theme’s font, whatever it names here.

pub fn from_bytes(bytes: impl Into<Rc<[u8]>>) -> Self

Adopts an already encoded list, which is what the protocol vectors carry.

pub fn with_font_table(self, table: impl Into<Rc<[u8]>>) -> Self

The same runs with an already encoded font table beside them.

pub fn as_bytes(&self) -> &[u8]

pub fn font_table(&self) -> &[u8]

The SpanFonts blob: a count, then one entry per run that names fonts, then the font lists themselves. Every offset in it counts from the start of the blob.

pub fn is_empty(&self) -> bool

pub fn font_entry_count(&self) -> usize

How many runs name fonts.

pub fn span_fonts(&self) -> Vec<(u32, Vec<FontRef>)>

The fonts each run that names any is set in, by the run’s index.

pub fn spans(&self) -> impl Iterator<Item = TextSpan> + '_

The runs this list holds, decoded again.

pub fn from_markdown(source: &str) -> (String, Self)

Turns a small, closed subset of markdown into a plain string and its spans.

**bold**, *italic* and `code`, and nothing else. It is a convenience, not a parser: anything it does not recognise is left in the string exactly as written, because silently eating a character a reader typed is worse than showing it.

Links are not here. A link needs a handler, and a handler is something the screen has rather than something a string can name.

Trait Implementations

impl Clone for TextSpans

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 TextSpans

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

Formats the value using the given formatter.

impl Default for TextSpans

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for TextSpans

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TextSpans