Struct Lowercase

pub struct Lowercase<'a>(Cow<'a, str>);

Wraps a string (either owned or &str) and guarantees that it’s lowercase.

This allows interfaces that expect lowercase strings to declare this expectation in their argument type, so that the caller can choose how to fulfill it.

Only ASCII characters are lowercased. This is faster than full unicode casemapping, and it matches what the game engine does.

The lowercase string is a Cow<str> internally, so it can be either owned or borrowed.

Tuple Fields

0: Cow<'a, str>

Implementations

impl<'a> Lowercase<'a>

pub fn new(s: &'a str) -> Self

Take a string and return the lowercased version.

pub fn new_unchecked(s: &'a str) -> Self

Take a string that is known to already be lowercase and return a Lowercase wrapper for it.

This operation is free.

pub fn from_string_unchecked(s: String) -> Self

Take an owned String that is known to already be lowercase and return a Lowercase wrapper

pub fn empty() -> &'static Self

pub fn as_str(&'a self) -> &'a str

pub fn into_cow(self) -> Cow<'a, str>

pub fn to_uppercase(&self) -> String

pub fn strip_prefix_unchecked<S: Borrow<str>>( &'a self, prefix: S, ) -> Option<Lowercase<'a>>

Like str::strip_prefix. Takes a prefix that is known to be already lowercase.

pub fn strip_suffix_unchecked<S: Borrow<str>>( &'a self, suffix: S, ) -> Option<Lowercase<'a>>

Like str::strip_suffix. Takes a suffix that is known to be already lowercase.

pub fn rmatch_indices_unchecked( &self, separator: char, ) -> RMatchIndices<'_, char>

pub fn slice<R: 'a + SliceIndex<str, Output = str>>(&'a self, range: R) -> Self

Trait Implementations

impl<'a> Borrow<Cow<'a, str>> for Lowercase<'a>

fn borrow(&self) -> &Cow<'a, str>

Immutably borrows from an owned value.

impl Borrow<str> for Lowercase<'_>

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl<'a> Clone for Lowercase<'a>

fn clone(&self) -> Lowercase<'a>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for Lowercase<'a>

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

Formats the value using the given formatter.

impl Default for Lowercase<'static>

fn default() -> Lowercase<'static>

Returns the “default value” for a type.

impl Display for Lowercase<'_>

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

Formats the value using the given formatter.

impl<'a> Hash for Lowercase<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> Ord for Lowercase<'a>

fn cmp(&self, other: &Lowercase<'a>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq<&str> for Lowercase<'_>

fn eq(&self, s: &&str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<String> for &Lowercase<'_>

fn eq(&self, s: &String) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for Lowercase<'_>

fn eq(&self, s: &str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialEq for Lowercase<'a>

fn eq(&self, other: &Lowercase<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialOrd for Lowercase<'a>

fn partial_cmp(&self, other: &Lowercase<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> TryFrom<&Lowercase<'a>> for BuiltinWidget

type Error = TryBuiltinWidgetError

The type returned in the event of a conversion error.

fn try_from(s: &Lowercase<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<&Lowercase<'a>> for WidgetProperty

type Error = TryWidgetPropertyError

The type returned in the event of a conversion error.

fn try_from(s: &Lowercase<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> Eq for Lowercase<'a>

impl<'a> StructuralPartialEq for Lowercase<'a>