Struct StyledStr 

pub struct StyledStr<'a> {
    pub s: &'a str,
    pub style: Option<Style>,
}

A borrowed string with an optional style annotation.

Example

let s = text_style::StyledStr::plain("test").bold();

let s1 = text_style::StyledStr::styled("test", text_style::Style::fg(text_style::AnsiColor::Red.dark()));
let s2 = text_style::StyledStr::plain("test").with(text_style::AnsiColor::Red.dark());
assert_eq!(s1, s2);

Fields

s: &'a str

The content of this string.

style: Option<Style>

The style of this string.

Implementations

impl<'a> StyledStr<'a>

pub fn new(s: &'a str, style: Option<Style>) -> StyledStr<'a>

Creates a new styled string from the given string and an optional style.

pub fn styled(s: &'a str, style: Style) -> StyledStr<'a>

Creates a new styled string from the given string and style.

pub fn plain(s: &'a str) -> StyledStr<'a>

Creates a new styled string from the given string without a style.

pub fn with(self, fg: Color) -> Self

Sets the foreground color for this styled string.

pub fn on(self, bg: Color) -> Self

Sets the background color for this styled string.

pub fn bold(self) -> Self

Sets the bold effect for this styled string.

pub fn italic(self) -> Self

Sets the italic effect for this styled string.

pub fn underline(self) -> Self

Sets the underline effect for this styled string.

pub fn strikethrough(self) -> Self

Sets the strikethrough effect for this styled string.

pub fn effect(self, effect: Effect) -> Self

Sets the given effect for this styled string.

pub fn style_mut(&mut self) -> &mut Style

Returns a mutable reference to the style of this string, creating a new style with the default settings if the style is currently None.

Trait Implementations

impl<'a> Clone for StyledStr<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for StyledStr<'a>

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

Formats the value using the given formatter.

impl<'a, 'b> From<&'b (Style, &'a str)> for StyledStr<'a>

fn from((style, s): &'b (Style, &'a str)) -> StyledStr<'a>

Converts to this type from the input type.

impl<'a, 'b> From<&'b StyledStr<'a>> for ANSIString<'a>

fn from(s: &'b StyledStr<'a>) -> ANSIString<'a>

Converts to this type from the input type.

impl<'a, 'b> From<&'b StyledStr<'a>> for StyledString

fn from(s: &'b StyledStr<'a>) -> StyledString

Converts to this type from the input type.

impl<'a, 'b> From<&'b StyledStr<'a>> for StyledContent<&'a str>

fn from(s: &'b StyledStr<'a>) -> StyledContent<&'a str>

Converts to this type from the input type.

impl<'a, 'b> From<&'b StyledStr<'a>> for StyledStr<'a>

fn from(s: &'b StyledStr<'a>) -> StyledStr<'a>

Converts to this type from the input type.

impl<'a, 's> From<&'a StyledStr<'s>> for StyledStr<'s>

fn from(s: &'a StyledStr<'s>) -> StyledStr<'s>

Converts to this type from the input type.

impl<'a, 's> From<&'a StyledStr<'s>> for StyledString

fn from(s: &'a StyledStr<'s>) -> StyledString

Converts to this type from the input type.

impl<'a> From<&'a StyledString> for StyledStr<'a>

fn from(s: &'a StyledString) -> StyledStr<'a>

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl<'a> From<(Style, &'a str)> for StyledStr<'a>

fn from((style, s): (Style, &'a str)) -> StyledStr<'a>

Converts to this type from the input type.

impl<'a> From<StyledStr<'a>> for ANSIString<'a>

fn from(s: StyledStr<'a>) -> ANSIString<'a>

Converts to this type from the input type.

impl<'a> From<StyledStr<'a>> for StyledString

fn from(s: StyledStr<'a>) -> StyledString

Converts to this type from the input type.

impl<'a> From<StyledStr<'a>> for StyledContent<&'a str>

fn from(s: StyledStr<'a>) -> StyledContent<&'a str>

Converts to this type from the input type.

impl<'a> From<StyledStr<'a>> for StyledString

fn from(s: StyledStr<'a>) -> StyledString

Converts to this type from the input type.

impl<'s> From<StyledStr<'s>> for StyledStr<'s>

fn from(s: StyledStr<'s>) -> StyledStr<'s>

Converts to this type from the input type.

impl<'s> From<StyledStr<'s>> for StyledString

fn from(s: StyledStr<'s>) -> StyledString

Converts to this type from the input type.

impl<'a> PartialEq for StyledStr<'a>

fn eq(&self, other: &StyledStr<'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> Termion for StyledStr<'a>

fn termion(&self) -> TermionStr<'_>

Convert this string into a TermionStr that can be formatted with termion.

impl<'a> StructuralPartialEq for StyledStr<'a>