1.0.0[−][src]Trait std::ascii::AsciiExt
use inherent methods instead
Extension methods for ASCII-subset only operations.
Be aware that operations on seemingly non-ASCII characters can sometimes have unexpected results. Consider this example:
use std::ascii::AsciiExt; assert_eq!(AsciiExt::to_ascii_uppercase("café"), "CAFÉ"); assert_eq!(AsciiExt::to_ascii_uppercase("café"), "CAFé");Run
In the first example, the lowercased string is represented "cafe\u{301}"
(the last character is an acute accent combining character). Unlike the
other characters in the string, the combining character will not get mapped
to an uppercase variant, resulting in "CAFE\u{301}"
. In the second
example, the lowercased string is represented "caf\u{e9}"
(the last
character is a single Unicode character representing an 'e' with an acute
accent). Since the last character is defined outside the scope of ASCII,
it will not get mapped to an uppercase variant, resulting in "CAF\u{e9}"
.
Associated Types
type Owned
use inherent methods instead
Container type for copied ASCII characters.
Required methods
fn is_ascii(&self) -> bool
use inherent methods instead
Checks if the value is within the ASCII range.
Note
This method will be deprecated in favor of the identically-named
inherent methods on u8
, char
, [u8]
and str
.
fn to_ascii_uppercase(&self) -> Self::Owned
use inherent methods instead
Makes a copy of the value in its ASCII upper case equivalent.
ASCII letters 'a' to 'z' are mapped to 'A' to 'Z', but non-ASCII letters are unchanged.
To uppercase the value in-place, use make_ascii_uppercase
.
To uppercase ASCII characters in addition to non-ASCII characters, use
str::to_uppercase
.
Note
This method will be deprecated in favor of the identically-named
inherent methods on u8
, char
, [u8]
and str
.
fn to_ascii_lowercase(&self) -> Self::Owned
use inherent methods instead
Makes a copy of the value in its ASCII lower case equivalent.
ASCII letters 'A' to 'Z' are mapped to 'a' to 'z', but non-ASCII letters are unchanged.
To lowercase the value in-place, use make_ascii_lowercase
.
To lowercase ASCII characters in addition to non-ASCII characters, use
str::to_lowercase
.
Note
This method will be deprecated in favor of the identically-named
inherent methods on u8
, char
, [u8]
and str
.
fn eq_ignore_ascii_case(&self, other: &Self) -> bool
use inherent methods instead
Checks that two values are an ASCII case-insensitive match.
Same as to_ascii_lowercase(a) == to_ascii_lowercase(b)
,
but without allocating and copying temporaries.
Note
This method will be deprecated in favor of the identically-named
inherent methods on u8
, char
, [u8]
and str
.
fn make_ascii_uppercase(&mut self)
1.9.0
use inherent methods instead
Converts this type to its ASCII upper case equivalent in-place.
ASCII letters 'a' to 'z' are mapped to 'A' to 'Z', but non-ASCII letters are unchanged.
To return a new uppercased value without modifying the existing one, use
to_ascii_uppercase
.
Note
This method will be deprecated in favor of the identically-named
inherent methods on u8
, char
, [u8]
and str
.
fn make_ascii_lowercase(&mut self)
1.9.0
use inherent methods instead
Converts this type to its ASCII lower case equivalent in-place.
ASCII letters 'A' to 'Z' are mapped to 'a' to 'z', but non-ASCII letters are unchanged.
To return a new lowercased value without modifying the existing one, use
to_ascii_lowercase
.
Note
This method will be deprecated in favor of the identically-named
inherent methods on u8
, char
, [u8]
and str
.
Implementors
impl AsciiExt for char
[src]
type Owned = char
use inherent methods instead
fn is_ascii(&self) -> bool
[src]
fn to_ascii_uppercase(&self) -> Self::Owned
[src]
fn to_ascii_lowercase(&self) -> Self::Owned
[src]
fn eq_ignore_ascii_case(&self, o: &Self) -> bool
[src]
fn make_ascii_uppercase(&mut self)
[src]
fn make_ascii_lowercase(&mut self)
[src]
impl AsciiExt for [u8]
[src]
type Owned = Vec<u8>
use inherent methods instead
fn is_ascii(&self) -> bool
[src]
fn to_ascii_uppercase(&self) -> Self::Owned
[src]
fn to_ascii_lowercase(&self) -> Self::Owned
[src]
fn eq_ignore_ascii_case(&self, o: &Self) -> bool
[src]
fn make_ascii_uppercase(&mut self)
[src]
fn make_ascii_lowercase(&mut self)
[src]
impl AsciiExt for str
[src]
type Owned = String
use inherent methods instead
fn is_ascii(&self) -> bool
[src]
fn to_ascii_uppercase(&self) -> Self::Owned
[src]
fn to_ascii_lowercase(&self) -> Self::Owned
[src]
fn eq_ignore_ascii_case(&self, o: &Self) -> bool
[src]
fn make_ascii_uppercase(&mut self)
[src]
fn make_ascii_lowercase(&mut self)
[src]
impl AsciiExt for u8
[src]
type Owned = u8
use inherent methods instead