Struct Line 

pub struct Line { /* private fields */ }

A single line of styled spans.

Implementations

impl Line

pub const fn new() -> Self

Create an empty line.

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

Create a line from spans.

pub fn raw(content: impl Into<String>) -> Self

Create a line from a single raw string.

pub fn styled(content: impl Into<String>, 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<'static>]

Get the spans.

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

Add a span to the line.

pub fn with_span<'a>(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>

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

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

Convert to segments.

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

Convert to a SegmentLine.

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

Iterate over spans.

Trait Implementations

impl Clone for Line

fn clone(&self) -> Line

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Line

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

Formats the value using the given formatter.

impl Default for Line

fn default() -> Line

Returns the “default value” for a type.

impl From<&str> for Line

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<Line> for Text

fn from(line: Line) -> Self

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl From<String> for Line

fn from(s: String) -> Self

Converts to this type from the input type.

impl FromIterator<Line> for Text

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

Creates a value from an iterator.

impl<'a> IntoIterator for &'a Line

type Item = &'a Span<'static>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for Line

type Item = Span<'static>

The type of the elements being iterated over.

type IntoIter = IntoIter<Span<'static>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Line

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

impl StructuralPartialEq for Line