bjoernager/rust
bjoernager/rust
1
Fork 0
Code Issues Pull requests Activity

Document unreachable!() custom panic message

Browse source 
The `unreachable!` docs previously did not mention that there was a second
form, `unreachable!("message")` that could be used to specify a custom panic
message,

The docs now mention this in the same style as currently used for `unimplemented!`:
https://doc.rust-lang.org/core/macro.unimplemented.html#panics
This commit is contained in:
Ed Morley 2021-11-11 13:41:21 +00:00
parent 62efba8a05
commit b41b2e5a5c
No known key found for this signature in database
GPG key ID: 8F3EFBB29664BE80
1 changed files with 5 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

7
library/core/src/macros/mod.rs
View file

@ -554,7 +554,10 @@ macro_rules! writeln {
/// ///
/// # Panics /// # Panics
/// ///
/// This will always [`panic!`]. /// This will always [`panic!`] because `unreachable!` is just a shorthand for `panic!` with a
/// fixed, specific message.
///
/// Like `panic!`, this macro has a second form for displaying custom values.
/// ///
/// # Examples /// # Examples
/// ///
@ -581,7 +584,7 @@ macro_rules! writeln {
/// if 3*i < i { panic!("u32 overflow"); } /// if 3*i < i { panic!("u32 overflow"); }
/// if x < 3*i { return i-1; } /// if x < 3*i { return i-1; }
/// } /// }
/// unreachable!(); /// unreachable!("The loop should always return");
/// } /// }
/// ``` /// ```
#[macro_export] #[macro_export]