Struct rocket::http::QMediaType
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§
§impl QMediaType
impl QMediaType
pub 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));pub 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);pub 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 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");pub 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");pub 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);pub 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));pub 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);pub 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.
pub 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());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 = _
pub 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.
pub 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
*/*.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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§
§impl Clone for QMediaType
impl Clone for QMediaType
§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 more§impl Debug for QMediaType
impl Debug for QMediaType
§impl Deref for QMediaType
impl Deref for QMediaType
§impl From<MediaType> for QMediaType
impl From<MediaType> for QMediaType
§fn from(media_type: MediaType) -> QMediaType
fn from(media_type: MediaType) -> QMediaType
§impl IntoIterator for QMediaType
impl IntoIterator for QMediaType
§type Item = QMediaType
type Item = QMediaType
§type IntoIter = Once<QMediaType>
type IntoIter = Once<QMediaType>
§fn into_iter(self) -> <QMediaType as IntoIterator>::IntoIter
fn into_iter(self) -> <QMediaType as IntoIterator>::IntoIter
§impl PartialEq for QMediaType
impl PartialEq for QMediaType
§fn eq(&self, other: &QMediaType) -> bool
fn eq(&self, other: &QMediaType) -> bool
self and other values to be equal, and is used
by ==.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<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
source§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
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> 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> 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);