nordic-dev.net/rust
nordic-dev.net/rust
2
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2025-02-25 05:14:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

(#93392) Update char::MAX docs and core::char::MAX

Browse Source
This commit is contained in:
George Bateman 2022-01-30 19:41:52 +00:00
parent 2fb617ca0f
commit 9aaf52b66a
No known key found for this signature in database
GPG Key ID: C417AA9C4039EFCF
2 changed files with 22 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
library/core/src/char/methods.rs
View File

@ -9,14 +9,19 @@ use super::*;
#[lang = "char"]
impl char {
/// The highest valid code point a `char` can have, 0x10FFFF.
/// The highest valid code point a `char` can have, `'\u{10FFFF}'`.
///
/// A [Code Point] is any value between zero and `char::MAX`, inclusive. A
/// `char` is a [Unicode Scalar Value], which is a Code Point that is not
/// in the range `0xD800..=0xDFFF`.
/// # Examples
///
/// [Unicode Scalar Value]: https://www.unicode.org/glossary/#unicode_scalar_value
/// [Code Point]: https://www.unicode.org/glossary/#code_point
/// ```
/// # fn something_which_returns_char() -> char { 'a' }
/// let c: char = something_which_returns_char();
/// assert!(c <= char::MAX);
///
/// let value_at_max = char::MAX as u32;
/// assert_eq!(char::from_u32(value_at_max), Some('\u{10FFFF}'));
/// assert_eq!(char::from_u32(value_at_max + 1), None);
/// ```
#[stable(feature = "assoc_char_consts", since = "1.52.0")]
pub const MAX: char = '\u{10ffff}';

17
library/core/src/char/mod.rs
View File

@ -89,14 +89,19 @@ const MAX_THREE_B: u32 = 0x10000;
Cn Unassigned a reserved unassigned code point or a noncharacter
*/
/// The highest valid code point a `char` can have.
/// The highest valid code point a `char` can have, `'\u{10FFFF}'`.
///
/// A [`char`] is a [Unicode Scalar Value], which means that it is a [Code
/// Point], but only ones within a certain range. `MAX` is the highest valid
/// code point that's a valid [Unicode Scalar Value].
/// # Examples
///
/// [Unicode Scalar Value]: https://www.unicode.org/glossary/#unicode_scalar_value
/// [Code Point]: https://www.unicode.org/glossary/#code_point
/// ```
/// # fn something_which_returns_char() -> char { 'a' }
/// let c: char = something_which_returns_char();
/// assert!(c <= char::MAX);
///
/// let value_at_max = char::MAX as u32;
/// assert_eq!(char::from_u32(value_at_max), Some('\u{10FFFF}'));
/// assert_eq!(char::from_u32(value_at_max + 1), None);
/// ```
#[stable(feature = "rust1", since = "1.0.0")]
pub const MAX: char = char::MAX;