Struct FgDynColorDisplay

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

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: DynColor + Copy, T: ?Sized> FgDynColorDisplay<'a, Fg, T>

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

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: DynColor>( self, bg: Bg, ) -> ComboDynColorDisplay<'a, Fg, Bg, T>

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: DynColor>( self, fg: NewFg, ) -> FgDynColorDisplay<'a, NewFg, T>

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: DynColor, T: ?Sized + Binary> Binary for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.

impl<'a, Color: DynColor, T: ?Sized + Debug> Debug for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.

impl<'a, Color: DynColor, T: ?Sized + Display> Display for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.

impl<'a, Color: DynColor, T: ?Sized + LowerExp> LowerExp for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.

impl<'a, Color: DynColor, T: ?Sized + LowerHex> LowerHex for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.

impl<'a, Color: DynColor, T: ?Sized + Octal> Octal for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.

impl<'a, Color: DynColor, T: ?Sized + Pointer> Pointer for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.

impl<'a, Color: DynColor, T: ?Sized + UpperExp> UpperExp for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.

impl<'a, Color: DynColor, T: ?Sized + UpperHex> UpperHex for FgDynColorDisplay<'a, Color, T>

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

Formats the value using the given formatter.