Struct FgDynColorDisplay 

pub struct FgDynColorDisplay<'a, Color, T>(/* private fields */)
where
    Color: DynColor,
    T: ?Sized;

Wrapper around a type which implements all the formatters the wrapped type does, with the addition of changing the foreground color. Is not recommended unless compile-time coloring is not an option.

Implementations

impl<'a, Fg, T> FgDynColorDisplay<'a, Fg, T>

where Fg: DynColor + Copy, T: ?Sized,

pub const fn new(thing: &'a T, color: Fg) -> FgDynColorDisplay<'a, Fg, T>

Create a new FgDynColorDisplay, from a reference to a type which implements DynColor.

This is a const function: in non-const contexts, [OwoColorize::color] may be more convenient.

Example

Usage in const contexts:

use owo_colors::{AnsiColors, FgDynColorDisplay};

const DYN_RED_TEXT: FgDynColorDisplay<AnsiColors, str> =
   FgDynColorDisplay::new("red text (dynamic)", AnsiColors::Red);

println!("{}", DYN_RED_TEXT);

pub fn into_styled(self) -> Styled<&'a T>

Convert self to a generic Styled.

This method erases color-related type parameters, and can be used to unify types across branches.

Example

use owo_colors::{AnsiColors, CssColors, OwoColorize};

fn is_blue() -> bool {
    // ...
}

let styled_str = if is_blue() {
    "hello".color(AnsiColors::Blue).into_styled()
} else {
    "hello".color(CssColors::DarkSeaGreen).into_styled()
};

println!("{}", styled_str);

pub const fn on_color<Bg>(self, bg: Bg) -> ComboDynColorDisplay<'a, Fg, Bg, T>

where Bg: DynColor,

Set the background color at runtime. Only use if you do not know what color to use at compile-time. If the color is constant, use either [OwoColorize::bg] or a color-specific method, such as [OwoColorize::on_yellow],

use owo_colors::{OwoColorize, AnsiColors};

println!("{}", "yellow background".on_color(AnsiColors::BrightYellow));

pub const fn color<NewFg>(self, fg: NewFg) -> FgDynColorDisplay<'a, NewFg, T>

where NewFg: DynColor,

Set the foreground color at runtime. Only use if you do not know which color will be used at compile-time. If the color is constant, use either [OwoColorize::fg] or a color-specific method, such as [OwoColorize::green],

use owo_colors::{OwoColorize, AnsiColors};

println!("{}", "green".color(AnsiColors::Green));

Trait Implementations

impl<'a, Color, T> Binary for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: Binary + ?Sized,

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

Formats the value using the given formatter.

impl<'a, Color, T> Debug for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: Debug + ?Sized,

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

Formats the value using the given formatter.

impl<'a, Color, T> Display for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: Display + ?Sized,

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

Formats the value using the given formatter.

impl<'a, Color, T> LowerExp for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: LowerExp + ?Sized,

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

Formats the value using the given formatter.

impl<'a, Color, T> LowerHex for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: LowerHex + ?Sized,

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

Formats the value using the given formatter.

impl<'a, Color, T> Octal for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: Octal + ?Sized,

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

Formats the value using the given formatter.

impl<'a, Color, T> Pointer for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: Pointer + ?Sized,

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

Formats the value using the given formatter.

impl<'a, Color, T> UpperExp for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: UpperExp + ?Sized,

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

Formats the value using the given formatter.

impl<'a, Color, T> UpperHex for FgDynColorDisplay<'a, Color, T>

where Color: DynColor, T: UpperHex + ?Sized,

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

Formats the value using the given formatter.