pub struct QMediaType(pub MediaType, pub Option<f32>);Expand description
A MediaType with an associated quality value.
Tuple Fields§
§0: MediaType§1: Option<f32>Implementations§
Source§impl QMediaType
impl QMediaType
Sourcepub fn weight(&self) -> Option<f32>
pub fn weight(&self) -> Option<f32>
Retrieve the weight of the media type, if there is any.
§Example
use rocket::http::{MediaType, QMediaType};
let q_type = QMediaType(MediaType::HTML, Some(0.3));
assert_eq!(q_type.weight(), Some(0.3));Sourcepub fn weight_or(&self, default: f32) -> f32
pub fn weight_or(&self, default: f32) -> f32
Retrieve the weight of the media type or a given default value.
§Example
use rocket::http::{MediaType, QMediaType};
let q_type = QMediaType(MediaType::HTML, Some(0.3));
assert_eq!(q_type.weight_or(0.9), 0.3);
let q_type = QMediaType(MediaType::HTML, None);
assert_eq!(q_type.weight_or(0.9), 0.9);Sourcepub fn media_type(&self) -> &MediaType
pub fn media_type(&self) -> &MediaType
Borrow the internal MediaType.
§Example
use rocket::http::{MediaType, QMediaType};
let q_type = QMediaType(MediaType::HTML, Some(0.3));
assert_eq!(q_type.media_type(), &MediaType::HTML);Methods from Deref<Target = MediaType>§
pub const Any: MediaType
pub const Binary: MediaType
pub const Bytes: MediaType
pub const HTML: MediaType
pub const Plain: MediaType
pub const Text: MediaType
pub const JSON: MediaType
pub const MsgPack: MediaType
pub const Form: MediaType
pub const JavaScript: MediaType
pub const CSS: MediaType
pub const FormData: MediaType
pub const XML: MediaType
pub const OPF: MediaType
pub const XHTML: MediaType
pub const CSV: MediaType
pub const PNG: MediaType
pub const GIF: MediaType
pub const BMP: MediaType
pub const JPEG: MediaType
pub const WEBP: MediaType
pub const AVIF: MediaType
pub const SVG: MediaType
pub const Icon: MediaType
pub const WEBM: MediaType
pub const WEBA: MediaType
pub const OGG: MediaType
pub const FLAC: MediaType
pub const WAV: MediaType
pub const PDF: MediaType
pub const TTF: MediaType
pub const OTF: MediaType
pub const WOFF: MediaType
pub const WOFF2: MediaType
pub const JsonApi: MediaType
pub const WASM: MediaType
pub const TIFF: MediaType
pub const AAC: MediaType
pub const Calendar: MediaType
pub const MPEG: MediaType
pub const TAR: MediaType
pub const GZIP: MediaType
pub const MOV: MediaType
pub const MP3: MediaType
pub const MP4: MediaType
pub const ZIP: MediaType
pub const CBZ: MediaType
pub const CBR: MediaType
pub const RAR: MediaType
pub const EPUB: MediaType
pub const EventStream: MediaType
pub const Markdown: MediaType
pub const EXE: MediaType
Sourcepub fn top(&self) -> &UncasedStr
pub fn top(&self) -> &UncasedStr
Returns the top-level type for this media type. The return type,
UncasedStr, has caseless equality comparison and hashing.
§Example
use rocket::http::MediaType;
let plain = MediaType::Plain;
assert_eq!(plain.top(), "text");
assert_eq!(plain.top(), "TEXT");
assert_eq!(plain.top(), "Text");Sourcepub fn sub(&self) -> &UncasedStr
pub fn sub(&self) -> &UncasedStr
Returns the subtype for this media type. The return type,
UncasedStr, has caseless equality comparison and hashing.
§Example
use rocket::http::MediaType;
let plain = MediaType::Plain;
assert_eq!(plain.sub(), "plain");
assert_eq!(plain.sub(), "PlaIN");
assert_eq!(plain.sub(), "pLaIn");Sourcepub fn specificity(&self) -> u8
pub fn specificity(&self) -> u8
Returns a u8 representing how specific the top-level type and subtype
of this media type are.
The return value is either 0, 1, or 2, where 2 is the most
specific. A 0 is returned when both the top and sublevel types are
*. A 1 is returned when only one of the top or sublevel types is
*, and a 2 is returned when neither the top or sublevel types are
*.
§Example
use rocket::http::MediaType;
let mt = MediaType::Plain;
assert_eq!(mt.specificity(), 2);
let mt = MediaType::new("text", "*");
assert_eq!(mt.specificity(), 1);
let mt = MediaType::Any;
assert_eq!(mt.specificity(), 0);Sourcepub fn exact_eq(&self, other: &MediaType) -> bool
pub fn exact_eq(&self, other: &MediaType) -> bool
Compares self with other and returns true if self and other
are exactly equal to each other, including with respect to their
parameters and their order.
This is different from the PartialEq implementation in that it
considers parameters. In particular, Eq implies PartialEq but
PartialEq does not imply Eq. That is, if PartialEq returns false,
this function is guaranteed to return false. Similarly, if exact_eq
returns true, PartialEq is guaranteed to return true. However, if
PartialEq returns true, exact_eq function may or may not return
true.
§Example
use rocket::http::MediaType;
let plain = MediaType::Plain;
let plain2 = MediaType::new("text", "plain").with_params(("charset", "utf-8"));
let just_plain = MediaType::new("text", "plain");
// The `PartialEq` implementation doesn't consider parameters.
assert!(plain == just_plain);
assert!(just_plain == plain2);
assert!(plain == plain2);
// While `exact_eq` does.
assert!(!plain.exact_eq(&just_plain));
assert!(!plain2.exact_eq(&just_plain));
assert!(plain.exact_eq(&plain2));Sourcepub fn params(&self) -> impl Iterator<Item = (&UncasedStr, &str)>
pub fn params(&self) -> impl Iterator<Item = (&UncasedStr, &str)>
Returns an iterator over the (key, value) pairs of the media type’s parameter list. The iterator will be empty if the media type has no parameters.
§Example
The MediaType::Plain type has one parameter: charset=utf-8:
use rocket::http::MediaType;
let plain = MediaType::Plain;
let (key, val) = plain.params().next().unwrap();
assert_eq!(key, "charset");
assert_eq!(val, "utf-8");The MediaType::PNG type has no parameters:
use rocket::http::MediaType;
let png = MediaType::PNG;
assert_eq!(png.params().count(), 0);Sourcepub fn param<'a>(&'a self, name: &str) -> Option<&'a str>
pub fn param<'a>(&'a self, name: &str) -> Option<&'a str>
Returns the first parameter with name name, if there is any.
Sourcepub fn extension(&self) -> Option<&UncasedStr>
pub fn extension(&self) -> Option<&UncasedStr>
Returns the most common file extension associated with the
Media-Type self if it is known. Otherwise, returns None.
The currently recognized extensions are identical to those in
MediaType::from_extension() with the most common extension being
the first extension appearing in the list for a given Content-Type.
§Example
Known extension:
use rocket::http::MediaType;
assert_eq!(MediaType::JSON.extension().unwrap(), "json");
assert_eq!(MediaType::JPEG.extension().unwrap(), "jpeg");
assert_eq!(MediaType::JPEG.extension().unwrap(), "JPEG");
assert_eq!(MediaType::PDF.extension().unwrap(), "pdf");An unknown extension:
use rocket::http::MediaType;
let foo = MediaType::new("foo", "bar");
assert!(foo.extension().is_none());Sourcepub fn is_known(&self) -> bool
pub fn is_known(&self) -> bool
Returns true if this MediaType is known to Rocket. In other words,
returns true if there is an associated constant for self.
Sourcepub fn is_any(&self) -> bool
pub fn is_any(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Any,
i.e
*/*.
Sourcepub fn is_binary(&self) -> bool
pub fn is_binary(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Binary,
i.e
application/octet-stream.
Sourcepub fn is_bytes(&self) -> bool
pub fn is_bytes(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Bytes,
i.e
application/octet-stream.
Sourcepub fn is_html(&self) -> bool
pub fn is_html(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::HTML,
i.e
text/html.
Sourcepub fn is_plain(&self) -> bool
pub fn is_plain(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Plain,
i.e
text/plain.
Sourcepub fn is_text(&self) -> bool
pub fn is_text(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Text,
i.e
text/plain.
Sourcepub fn is_json(&self) -> bool
pub fn is_json(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::JSON,
i.e
application/json.
Sourcepub fn is_msgpack(&self) -> bool
pub fn is_msgpack(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::MsgPack,
i.e
application/msgpack.
Sourcepub fn is_form(&self) -> bool
pub fn is_form(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Form,
i.e
application/x-www-form-urlencoded.
Sourcepub fn is_javascript(&self) -> bool
pub fn is_javascript(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::JavaScript,
i.e
text/javascript.
Sourcepub fn is_css(&self) -> bool
pub fn is_css(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::CSS,
i.e
text/css.
Sourcepub fn is_form_data(&self) -> bool
pub fn is_form_data(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::FormData,
i.e
multipart/form-data.
Sourcepub fn is_xml(&self) -> bool
pub fn is_xml(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::XML,
i.e
text/xml.
Sourcepub fn is_opf(&self) -> bool
pub fn is_opf(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::OPF,
i.e
application/oebps-package+xml.
Sourcepub fn is_xhtml(&self) -> bool
pub fn is_xhtml(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::XHTML,
i.e
application/xhtml+xml.
Sourcepub fn is_csv(&self) -> bool
pub fn is_csv(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::CSV,
i.e
text/csv.
Sourcepub fn is_png(&self) -> bool
pub fn is_png(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::PNG,
i.e
image/png.
Sourcepub fn is_gif(&self) -> bool
pub fn is_gif(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::GIF,
i.e
image/gif.
Sourcepub fn is_bmp(&self) -> bool
pub fn is_bmp(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::BMP,
i.e
image/bmp.
Sourcepub fn is_jpeg(&self) -> bool
pub fn is_jpeg(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::JPEG,
i.e
image/jpeg.
Sourcepub fn is_webp(&self) -> bool
pub fn is_webp(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::WEBP,
i.e
image/webp.
Sourcepub fn is_avif(&self) -> bool
pub fn is_avif(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::AVIF,
i.e
image/avif.
Sourcepub fn is_svg(&self) -> bool
pub fn is_svg(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::SVG,
i.e
image/svg+xml.
Sourcepub fn is_icon(&self) -> bool
pub fn is_icon(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Icon,
i.e
image/x-icon.
Sourcepub fn is_webm(&self) -> bool
pub fn is_webm(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::WEBM,
i.e
video/webm.
Sourcepub fn is_weba(&self) -> bool
pub fn is_weba(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::WEBA,
i.e
audio/webm.
Sourcepub fn is_ogg(&self) -> bool
pub fn is_ogg(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::OGG,
i.e
video/ogg.
Sourcepub fn is_flac(&self) -> bool
pub fn is_flac(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::FLAC,
i.e
audio/flac.
Sourcepub fn is_wav(&self) -> bool
pub fn is_wav(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::WAV,
i.e
audio/wav.
Sourcepub fn is_pdf(&self) -> bool
pub fn is_pdf(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::PDF,
i.e
application/pdf.
Sourcepub fn is_ttf(&self) -> bool
pub fn is_ttf(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::TTF,
i.e
application/font-sfnt.
Sourcepub fn is_otf(&self) -> bool
pub fn is_otf(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::OTF,
i.e
application/font-sfnt.
Sourcepub fn is_woff(&self) -> bool
pub fn is_woff(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::WOFF,
i.e
application/font-woff.
Sourcepub fn is_woff2(&self) -> bool
pub fn is_woff2(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::WOFF2,
i.e
font/woff2.
Sourcepub fn is_json_api(&self) -> bool
pub fn is_json_api(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::JsonApi,
i.e
application/vnd.api+json.
Sourcepub fn is_wasm(&self) -> bool
pub fn is_wasm(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::WASM,
i.e
application/wasm.
Sourcepub fn is_tiff(&self) -> bool
pub fn is_tiff(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::TIFF,
i.e
image/tiff.
Sourcepub fn is_aac(&self) -> bool
pub fn is_aac(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::AAC,
i.e
audio/aac.
Sourcepub fn is_ical(&self) -> bool
pub fn is_ical(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Calendar,
i.e
text/calendar.
Sourcepub fn is_mpeg(&self) -> bool
pub fn is_mpeg(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::MPEG,
i.e
video/mpeg.
Sourcepub fn is_tar(&self) -> bool
pub fn is_tar(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::TAR,
i.e
application/x-tar.
Sourcepub fn is_gzip(&self) -> bool
pub fn is_gzip(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::GZIP,
i.e
application/gzip.
Sourcepub fn is_mov(&self) -> bool
pub fn is_mov(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::MOV,
i.e
video/quicktime.
Sourcepub fn is_mp3(&self) -> bool
pub fn is_mp3(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::MP3,
i.e
audio/mpeg.
Sourcepub fn is_mp4(&self) -> bool
pub fn is_mp4(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::MP4,
i.e
video/mp4.
Sourcepub fn is_zip(&self) -> bool
pub fn is_zip(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::ZIP,
i.e
application/zip.
Sourcepub fn is_cbz(&self) -> bool
pub fn is_cbz(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::CBZ,
i.e
application/vnd.comicbook+zip.
Sourcepub fn is_cbr(&self) -> bool
pub fn is_cbr(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::CBR,
i.e
application/vnd.comicbook-rar.
Sourcepub fn is_rar(&self) -> bool
pub fn is_rar(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::RAR,
i.e
application/vnd.rar.
Sourcepub fn is_epub(&self) -> bool
pub fn is_epub(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::EPUB,
i.e
application/epub+zip.
Sourcepub fn is_event_stream(&self) -> bool
pub fn is_event_stream(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::EventStream,
i.e
text/event-stream.
Sourcepub fn is_markdown(&self) -> bool
pub fn is_markdown(&self) -> bool
Returns true if the top-level and sublevel types of
self are the same as those of
MediaType::Markdown,
i.e
text/markdown.
Trait Implementations§
Source§impl Clone for QMediaType
impl Clone for QMediaType
Source§fn clone(&self) -> QMediaType
fn clone(&self) -> QMediaType
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl Debug for QMediaType
impl Debug for QMediaType
Source§impl Deref for QMediaType
impl Deref for QMediaType
Source§impl From<MediaType> for QMediaType
impl From<MediaType> for QMediaType
Source§fn from(media_type: MediaType) -> QMediaType
fn from(media_type: MediaType) -> QMediaType
Source§impl PartialEq for QMediaType
impl PartialEq for QMediaType
impl StructuralPartialEq for QMediaType
Auto Trait Implementations§
impl Freeze for QMediaType
impl RefUnwindSafe for QMediaType
impl Send for QMediaType
impl Sync for QMediaType
impl Unpin for QMediaType
impl UnwindSafe for QMediaType
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoCollection<T> for T
impl<T> IntoCollection<T> for T
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the foreground set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red() and
green(), which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg():
use yansi::{Paint, Color};
painted.fg(Color::White);Set foreground color to white using white().
use yansi::Paint;
painted.white();Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Returns self with the
fg()
set to
Color::BrightBlack.
§Example
println!("{}", value.bright_black());Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Returns self with the
fg()
set to
Color::BrightGreen.
§Example
println!("{}", value.bright_green());Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Returns self with the
fg()
set to
Color::BrightYellow.
§Example
println!("{}", value.bright_yellow());Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Returns self with the
fg()
set to
Color::BrightMagenta.
§Example
println!("{}", value.bright_magenta());Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Returns self with the
fg()
set to
Color::BrightWhite.
§Example
println!("{}", value.bright_white());Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the background set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red() and
on_green(), which have the same functionality but
are pithier.
§Example
Set background color to red using fg():
use yansi::{Paint, Color};
painted.bg(Color::Red);Set background color to red using on_red().
use yansi::Paint;
painted.on_red();Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Returns self with the
bg()
set to
Color::BrightBlack.
§Example
println!("{}", value.on_bright_black());Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Returns self with the
bg()
set to
Color::BrightGreen.
§Example
println!("{}", value.on_bright_green());Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Returns self with the
bg()
set to
Color::BrightYellow.
§Example
println!("{}", value.on_bright_yellow());Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Returns self with the
bg()
set to
Color::BrightBlue.
§Example
println!("{}", value.on_bright_blue());Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Returns self with the
bg()
set to
Color::BrightMagenta.
§Example
println!("{}", value.on_bright_magenta());Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Returns self with the
bg()
set to
Color::BrightCyan.
§Example
println!("{}", value.on_bright_cyan());Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Returns self with the
bg()
set to
Color::BrightWhite.
§Example
println!("{}", value.on_bright_white());Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute value.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold() and
underline(), which have the same functionality
but are pithier.
§Example
Make text bold using attr():
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);Make text bold using using bold().
use yansi::Paint;
painted.bold();Source§fn underline(&self) -> Painted<&T>
fn underline(&self) -> Painted<&T>
Returns self with the
attr()
set to
Attribute::Underline.
§Example
println!("{}", value.underline());Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Returns self with the
attr()
set to
Attribute::RapidBlink.
§Example
println!("{}", value.rapid_blink());Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi Quirk value.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask() and
wrap(), which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk():
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);Enable wrapping using wrap().
use yansi::Paint;
painted.wrap();Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted only when both stdout and stderr are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);