/// # Examples
///
/// ```
- /// let mut v = String::from("🗻∈🌏");
+ /// let v = String::from("🗻∈🌏");
///
/// assert_eq!(Some("🗻"), v.get(0..4));
///
/// // indices not on UTF-8 sequence boundaries
- /// assert!(v.get_mut(1..).is_none());
- /// assert!(v.get_mut(..8).is_none());
+ /// assert!(v.get(1..).is_none());
+ /// assert!(v.get(..8).is_none());
///
/// // out of bounds
- /// assert!(v.get_mut(..42).is_none());
+ /// assert!(v.get(..42).is_none());
/// ```
#[stable(feature = "str_checked_slicing", since = "1.20.0")]
#[inline]
let me = unsafe { self.as_bytes_mut() };
me.make_ascii_lowercase()
}
-
- /// Checks if all characters of this string are ASCII alphabetic
- /// characters:
- ///
- /// - U+0041 'A' ... U+005A 'Z', or
- /// - U+0061 'a' ... U+007A 'z'.
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_alphabetic(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_alphabetic())
- }
-
- /// Checks if all characters of this string are ASCII uppercase characters:
- /// U+0041 'A' ... U+005A 'Z'.
- ///
- /// # Example
- ///
- /// ```
- /// #![feature(ascii_ctype)]
- ///
- /// // Only ascii uppercase characters
- /// assert!("HELLO".is_ascii_uppercase());
- ///
- /// // While all characters are ascii, 'y' and 'e' are not uppercase
- /// assert!(!"Bye".is_ascii_uppercase());
- ///
- /// // While all characters are uppercase, 'Ü' is not ascii
- /// assert!(!"TSCHÜSS".is_ascii_uppercase());
- /// ```
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_uppercase(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_uppercase())
- }
-
- /// Checks if all characters of this string are ASCII lowercase characters:
- /// U+0061 'a' ... U+007A 'z'.
- ///
- /// # Example
- ///
- /// ```
- /// #![feature(ascii_ctype)]
- ///
- /// // Only ascii uppercase characters
- /// assert!("hello".is_ascii_lowercase());
- ///
- /// // While all characters are ascii, 'B' is not lowercase
- /// assert!(!"Bye".is_ascii_lowercase());
- ///
- /// // While all characters are lowercase, 'Ü' is not ascii
- /// assert!(!"tschüss".is_ascii_lowercase());
- /// ```
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_lowercase(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_lowercase())
- }
-
- /// Checks if all characters of this string are ASCII alphanumeric
- /// characters:
- ///
- /// - U+0041 'A' ... U+005A 'Z', or
- /// - U+0061 'a' ... U+007A 'z', or
- /// - U+0030 '0' ... U+0039 '9'.
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_alphanumeric(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_alphanumeric())
- }
-
- /// Checks if all characters of this string are ASCII decimal digit:
- /// U+0030 '0' ... U+0039 '9'.
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_digit(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_digit())
- }
-
- /// Checks if all characters of this string are ASCII hexadecimal digits:
- ///
- /// - U+0030 '0' ... U+0039 '9', or
- /// - U+0041 'A' ... U+0046 'F', or
- /// - U+0061 'a' ... U+0066 'f'.
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_hexdigit(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_hexdigit())
- }
-
- /// Checks if all characters of this string are ASCII punctuation
- /// characters:
- ///
- /// - U+0021 ... U+002F `! " # $ % & ' ( ) * + , - . /`, or
- /// - U+003A ... U+0040 `: ; < = > ? @`, or
- /// - U+005B ... U+0060 `[ \\ ] ^ _ \``, or
- /// - U+007B ... U+007E `{ | } ~`
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_punctuation(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_punctuation())
- }
-
- /// Checks if all characters of this string are ASCII graphic characters:
- /// U+0021 '@' ... U+007E '~'.
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_graphic(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_graphic())
- }
-
- /// Checks if all characters of this string are ASCII whitespace characters:
- /// U+0020 SPACE, U+0009 HORIZONTAL TAB, U+000A LINE FEED,
- /// U+000C FORM FEED, or U+000D CARRIAGE RETURN.
- ///
- /// Rust uses the WhatWG Infra Standard's [definition of ASCII
- /// whitespace][infra-aw]. There are several other definitions in
- /// wide use. For instance, [the POSIX locale][pct] includes
- /// U+000B VERTICAL TAB as well as all the above characters,
- /// but—from the very same specification—[the default rule for
- /// "field splitting" in the Bourne shell][bfs] considers *only*
- /// SPACE, HORIZONTAL TAB, and LINE FEED as whitespace.
- ///
- /// If you are writing a program that will process an existing
- /// file format, check what that format's definition of whitespace is
- /// before using this function.
- ///
- /// [infra-aw]: https://infra.spec.whatwg.org/#ascii-whitespace
- /// [pct]: http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html#tag_07_03_01
- /// [bfs]: http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_06_05
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_whitespace(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_whitespace())
- }
-
- /// Checks if all characters of this string are ASCII control characters:
- ///
- /// - U+0000 NUL ... U+001F UNIT SEPARATOR, or
- /// - U+007F DELETE.
- ///
- /// Note that most ASCII whitespace characters are control
- /// characters, but SPACE is not.
- #[unstable(feature = "ascii_ctype", issue = "39658")]
- #[inline]
- pub fn is_ascii_control(&self) -> bool {
- self.bytes().all(|b| b.is_ascii_control())
- }
}
/// Converts a boxed slice of bytes to a boxed string slice without checking