diff --git a/library/core/src/num/int_macros.rs b/library/core/src/num/int_macros.rs index e674ce46a330..96510ee4dca6 100644 --- a/library/core/src/num/int_macros.rs +++ b/library/core/src/num/int_macros.rs @@ -185,8 +185,8 @@ macro_rules! int_impl { /// Returns the bit pattern of `self` reinterpreted as an unsigned integer of the same size. /// - /// This is a bit safer than `as` because it wouldn't silently change the size if the code - /// is refactored. + /// This produces the same result as an `as` cast, but ensures that the bit-width remains + /// the same. /// /// # Examples /// diff --git a/library/core/src/num/uint_macros.rs b/library/core/src/num/uint_macros.rs index 229f5ac58780..1491c27372bf 100644 --- a/library/core/src/num/uint_macros.rs +++ b/library/core/src/num/uint_macros.rs @@ -186,8 +186,8 @@ macro_rules! uint_impl { /// Returns the bit pattern of `self` reinterpreted as a signed integer of the same size. /// - /// This is a bit safer than `as` because it wouldn't silently change the size if the code - /// is refactored. + /// This produces the same result as an `as` cast, but ensures that the bit-width remains + /// the same. /// /// # Examples ///