Struct Span 

pub struct Span { /* private fields */ }

A run of text in one style, on one line.

A span holds no character that is_unsafe refuses, so no escape sequence, directional override, or line separator reaches a terminal through it. It holds no tab either. A cluster never spans two spans, so a line’s width is the sum of its spans’ widths.

Its Display prints the text without the style.

Implementations

impl Span

pub fn new(text: impl AsRef<str>, style: Style) -> Self

A span of text in style.

Tabs expand to the next multiple of TAB_WIDTH cells, counted from the start of the span. That is right for a span that starts its line.

A span is one line, so every line break becomes a space, and the words around it stay apart. The line breaks are newline, carriage return, vertical tab, form feed, next line, and the line and paragraph separators. Every other unsafe character is removed.

Build text that spans lines, or follows other spans on a line, with Text. It splits at each newline and counts tab stops from the line start.

To keep an owned String as the span’s text when it needs no change, use Span::from(string).

pub fn text(&self) -> &str

The text, without escape sequences, tabs, or line breaks.

pub fn style(&self) -> Style

The style the text is drawn in. Layout never changes it.

pub fn width(&self) -> u16

The width of the text in terminal cells.

Trait Implementations

impl Clone for Span

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 Span

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

Formats the value using the given formatter.

impl Display for Span

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

Formats the value using the given formatter.

impl Eq for Span

impl Extend<Span> for Line

fn extend<I: IntoIterator<Item = Span>>(&mut self, spans: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: T)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl From<&str> for Span

fn from(text: &str) -> Self

Converts to this type from the input type.

impl From<Span> for Line

fn from(span: Span) -> Self

Converts to this type from the input type.

impl From<Span> for Text

fn from(span: Span) -> Self

Converts to this type from the input type.

impl From<String> for Span

fn from(text: String) -> Self

Converts to this type from the input type.

impl FromIterator<Span> for Line

fn from_iter<I: IntoIterator<Item = Span>>(spans: I) -> Self

Creates a value from an iterator.

impl Hash for Span

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Span

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Span