Struct Line 

pub struct Line<'a> { /* private fields */ }

A single line of styled spans.

Implementations

impl<'a> Line<'a>

pub const fn new() -> Self

Create an empty line.

pub fn from_spans(spans: impl IntoIterator<Item = Span<'a>>) -> Self

Create a line from spans.

pub fn raw(content: impl Into<Cow<'a, str>>) -> Self

Create a line from a single raw string.

pub fn styled(content: impl Into<Cow<'a, str>>, style: Style) -> Self

Create a line from a single styled string.

pub fn is_empty(&self) -> bool

Check if the line is empty.

pub fn len(&self) -> usize

Get the number of spans.

pub fn width(&self) -> usize

Get the display width in cells.

pub fn measurement(&self) -> TextMeasurement

Return bounds-based measurement for this line.

pub fn spans(&self) -> &[Span<'a>]

Get the spans.

pub fn push_span(&mut self, span: Span<'a>)

Add a span to the line.

pub fn with_span(self, span: Span<'a>) -> Self

Append a span (builder pattern).

pub fn apply_base_style(&mut self, base: Style)

Apply a base style to all spans.

The base style is merged with each span’s style, with the span’s style taking precedence for conflicting properties.

pub fn to_plain_text(&self) -> String

Get the plain text content.

pub fn wrap(&self, width: usize, mode: WrapMode) -> Vec<Line<'a>>

Wrap this line to the given width, preserving span styles.

pub fn into_segments(self) -> Vec<Segment<'a>>

Convert to segments.

pub fn into_segment_line(self) -> SegmentLine<'a>

Convert to a SegmentLine.

pub fn iter(&self) -> impl Iterator<Item = &Span<'a>>

Iterate over spans.

Trait Implementations

impl<'a> Clone for Line<'a>

fn clone(&self) -> Line<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Line<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Line<'a>

fn default() -> Line<'a>

Returns the “default value” for a type.

impl<'a> From<&'a str> for Line<'a>

fn from(s: &'a str) -> Self

Converts to this type from the input type.

impl<'a> From<Line<'a>> for Text<'a>

fn from(line: Line<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Span<'a>> for Line<'a>

fn from(span: Span<'a>) -> Self

Converts to this type from the input type.

impl From<String> for Line<'static>

fn from(s: String) -> Self

Converts to this type from the input type.

impl<'a> FromIterator<Line<'a>> for Text<'a>

fn from_iter<I: IntoIterator<Item = Line<'a>>>(iter: I) -> Self

Creates a value from an iterator.

impl<'a> Hash for Line<'a>

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<'a> IntoIterator for &'a Line<'a>

type Item = &'a Span<'a>

The type of the elements being iterated over.

type IntoIter = Iter<'a, Span<'a>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for Line<'a>

type Item = Span<'a>

The type of the elements being iterated over.

type IntoIter = IntoIter<Span<'a>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> PartialEq for Line<'a>

fn eq(&self, other: &Line<'a>) -> 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<'a> Eq for Line<'a>

impl<'a> StructuralPartialEq for Line<'a>