Struct rocket_http::uncased::UncasedStr
source · pub struct UncasedStr(/* private fields */);
Expand description
A cost-free reference to an uncased (case-insensitive, case-preserving) ASCII string.
This is typically created from an &str
as follows:
use uncased::UncasedStr;
let ascii_ref: &UncasedStr = "Hello, world!".into();
Implementations§
source§impl UncasedStr
impl UncasedStr
sourcepub const fn new(string: &str) -> &UncasedStr
pub const fn new(string: &str) -> &UncasedStr
Cost-free conversion from an &str
reference to an UncasedStr
.
This is a const fn
on Rust 1.56+.
Example
use uncased::UncasedStr;
let uncased_str = UncasedStr::new("Hello!");
assert_eq!(uncased_str, "hello!");
assert_eq!(uncased_str, "Hello!");
assert_eq!(uncased_str, "HeLLo!");
sourcepub fn as_str(&self) -> &str
pub fn as_str(&self) -> &str
Returns self
as an &str
.
Example
use uncased::UncasedStr;
let uncased_str = UncasedStr::new("Hello!");
assert_eq!(uncased_str.as_str(), "Hello!");
assert_ne!(uncased_str.as_str(), "hELLo!");
sourcepub fn len(&self) -> usize
pub fn len(&self) -> usize
Returns the length, in bytes, of self
.
Example
use uncased::UncasedStr;
let uncased_str = UncasedStr::new("Hello!");
assert_eq!(uncased_str.len(), 6);
sourcepub fn is_empty(&self) -> bool
pub fn is_empty(&self) -> bool
Returns true
if self
has a length of zero bytes.
Examples
use uncased::UncasedStr;
let s = UncasedStr::new("");
assert!(s.is_empty());
let s = UncasedStr::new("not empty");
assert!(!s.is_empty());
sourcepub fn starts_with(&self, string: &str) -> bool
pub fn starts_with(&self, string: &str) -> bool
Returns true
if self
starts with any casing of the string string
;
otherwise, returns false
.
Example
use uncased::UncasedStr;
let uncased_str = UncasedStr::new("MoOO");
assert!(uncased_str.starts_with("moo"));
assert!(uncased_str.starts_with("MOO"));
assert!(uncased_str.starts_with("MOOO"));
assert!(!uncased_str.starts_with("boo"));
let uncased_str = UncasedStr::new("Bèe");
assert!(!uncased_str.starts_with("Be"));
assert!(uncased_str.starts_with("Bè"));
assert!(uncased_str.starts_with("Bè"));
assert!(uncased_str.starts_with("bèe"));
assert!(uncased_str.starts_with("BèE"));
sourcepub fn into_uncased(self: Box<UncasedStr>) -> Uncased<'static>
Available on crate feature alloc
only.
pub fn into_uncased(self: Box<UncasedStr>) -> Uncased<'static>
alloc
only.Converts a Box<UncasedStr>
into an Uncased
without copying or
allocating.
Example
use uncased::Uncased;
let uncased = Uncased::new("Hello!");
let boxed = uncased.clone().into_boxed_uncased();
assert_eq!(boxed.into_uncased(), uncased);
Trait Implementations§
source§impl AsRef<[u8]> for UncasedStr
impl AsRef<[u8]> for UncasedStr
source§impl AsRef<UncasedStr> for Uncased<'_>
impl AsRef<UncasedStr> for Uncased<'_>
source§fn as_ref(&self) -> &UncasedStr
fn as_ref(&self) -> &UncasedStr
source§impl AsRef<str> for UncasedStr
impl AsRef<str> for UncasedStr
source§impl Borrow<UncasedStr> for Uncased<'_>
impl Borrow<UncasedStr> for Uncased<'_>
source§fn borrow(&self) -> &UncasedStr
fn borrow(&self) -> &UncasedStr
source§impl Debug for UncasedStr
impl Debug for UncasedStr
source§impl Display for UncasedStr
impl Display for UncasedStr
source§impl<'s, 'c> From<&'c UncasedStr> for Uncased<'s>where
'c: 's,
impl<'s, 'c> From<&'c UncasedStr> for Uncased<'s>where 'c: 's,
source§fn from(string: &'c UncasedStr) -> Uncased<'s>
fn from(string: &'c UncasedStr) -> Uncased<'s>
source§impl<'a> From<&'a str> for &'a UncasedStr
impl<'a> From<&'a str> for &'a UncasedStr
source§fn from(string: &'a str) -> &'a UncasedStr
fn from(string: &'a str) -> &'a UncasedStr
source§impl Hash for UncasedStr
impl Hash for UncasedStr
source§impl<I> Index<I> for UncasedStrwhere
I: SliceIndex<str, Output = str>,
impl<I> Index<I> for UncasedStrwhere I: SliceIndex<str, Output = str>,
§type Output = UncasedStr
type Output = UncasedStr
source§impl Ord for UncasedStr
impl Ord for UncasedStr
source§impl PartialEq<&Uncased<'_>> for UncasedStr
impl PartialEq<&Uncased<'_>> for UncasedStr
source§impl PartialEq<&UncasedStr> for Uncased<'_>
impl PartialEq<&UncasedStr> for Uncased<'_>
source§fn eq(&self, other: &&UncasedStr) -> bool
fn eq(&self, other: &&UncasedStr) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialEq<&UncasedStr> for str
impl PartialEq<&UncasedStr> for str
source§fn eq(&self, other: &&UncasedStr) -> bool
fn eq(&self, other: &&UncasedStr) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialEq<&str> for UncasedStr
impl PartialEq<&str> for UncasedStr
source§impl PartialEq<String> for UncasedStr
impl PartialEq<String> for UncasedStr
source§impl PartialEq<Uncased<'_>> for &UncasedStr
impl PartialEq<Uncased<'_>> for &UncasedStr
source§impl PartialEq<Uncased<'_>> for UncasedStr
impl PartialEq<Uncased<'_>> for UncasedStr
source§impl PartialEq<UncasedStr> for &Uncased<'_>
impl PartialEq<UncasedStr> for &Uncased<'_>
source§fn eq(&self, other: &UncasedStr) -> bool
fn eq(&self, other: &UncasedStr) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialEq<UncasedStr> for &str
impl PartialEq<UncasedStr> for &str
source§fn eq(&self, other: &UncasedStr) -> bool
fn eq(&self, other: &UncasedStr) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialEq<UncasedStr> for Uncased<'_>
impl PartialEq<UncasedStr> for Uncased<'_>
source§fn eq(&self, other: &UncasedStr) -> bool
fn eq(&self, other: &UncasedStr) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialEq<UncasedStr> for str
impl PartialEq<UncasedStr> for str
source§fn eq(&self, other: &UncasedStr) -> bool
fn eq(&self, other: &UncasedStr) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialEq<str> for &UncasedStr
impl PartialEq<str> for &UncasedStr
source§impl PartialEq<str> for UncasedStr
impl PartialEq<str> for UncasedStr
source§impl PartialEq for UncasedStr
impl PartialEq for UncasedStr
source§fn eq(&self, other: &UncasedStr) -> bool
fn eq(&self, other: &UncasedStr) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialOrd<&Uncased<'_>> for UncasedStr
impl PartialOrd<&Uncased<'_>> for UncasedStr
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<&UncasedStr> for Uncased<'_>
impl PartialOrd<&UncasedStr> for Uncased<'_>
source§fn partial_cmp(&self, other: &&UncasedStr) -> Option<Ordering>
fn partial_cmp(&self, other: &&UncasedStr) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<String> for UncasedStr
impl PartialOrd<String> for UncasedStr
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<Uncased<'_>> for &UncasedStr
impl PartialOrd<Uncased<'_>> for &UncasedStr
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<Uncased<'_>> for UncasedStr
impl PartialOrd<Uncased<'_>> for UncasedStr
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<UncasedStr> for &Uncased<'_>
impl PartialOrd<UncasedStr> for &Uncased<'_>
source§fn partial_cmp(&self, other: &UncasedStr) -> Option<Ordering>
fn partial_cmp(&self, other: &UncasedStr) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<UncasedStr> for Uncased<'_>
impl PartialOrd<UncasedStr> for Uncased<'_>
source§fn partial_cmp(&self, other: &UncasedStr) -> Option<Ordering>
fn partial_cmp(&self, other: &UncasedStr) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<UncasedStr> for str
impl PartialOrd<UncasedStr> for str
source§fn partial_cmp(&self, other: &UncasedStr) -> Option<Ordering>
fn partial_cmp(&self, other: &UncasedStr) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<str> for UncasedStr
impl PartialOrd<str> for UncasedStr
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd for UncasedStr
impl PartialOrd for UncasedStr
source§fn partial_cmp(&self, other: &UncasedStr) -> Option<Ordering>
fn partial_cmp(&self, other: &UncasedStr) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moreimpl Eq for UncasedStr
Auto Trait Implementations§
impl RefUnwindSafe for UncasedStr
impl Send for UncasedStr
impl !Sized for UncasedStr
impl Sync for UncasedStr
impl Unpin for UncasedStr
impl UnwindSafe for UncasedStr
Blanket Implementations§
source§impl<T> AsUncased for Twhere
T: AsRef<str> + ?Sized,
impl<T> AsUncased for Twhere T: AsRef<str> + ?Sized,
source§fn as_uncased(&self) -> &UncasedStr
fn as_uncased(&self) -> &UncasedStr
self
to an UncasedStr
.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
§impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere T: ?Sized,
§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();
§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
§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();
§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
§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();
§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
§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();
§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);