try_cast_aligned: avoid bare int-to-ptr casts

Author: RalfJung

library/core/src/ptr/const_ptr.rs

@@ -75,13 +75,14 @@ impl<T: ?Sized> *const T {
     ///
     /// ```rust
     /// #![feature(pointer_try_cast_aligned)]
+    /// use std::ptr;
     ///
-    /// let aligned: *const u8 = 0x1000 as _;
+    /// let aligned: *const u8 = ptr::without_provenance(0x1000);
     ///
     /// // i32 has at most 4-byte alignment, so this will succeed
     /// assert!(aligned.try_cast_aligned::<i32>().is_some());
     ///
-    /// let unaligned: *const u8 = 0x1001 as _;
+    /// let unaligned: *const u8 = ptr::without_provenance(0x1001);
     ///
     /// // i32 has at least 2-byte alignment, so this will fail
     /// assert!(unaligned.try_cast_aligned::<i32>().is_none());

library/core/src/ptr/mut_ptr.rs

@@ -57,13 +57,14 @@ impl<T: ?Sized> *mut T {
     ///
     /// ```rust
     /// #![feature(pointer_try_cast_aligned)]
+    /// use std::ptr;
     ///
-    /// let aligned: *mut u8 = 0x1000 as _;
+    /// let aligned: *mut u8 = ptr::without_provenance_mut(0x1000);
     ///
     /// // i32 has at most 4-byte alignment, so this will succeed
     /// assert!(aligned.try_cast_aligned::<i32>().is_some());
     ///
-    /// let unaligned: *mut u8 = 0x1001 as _;
+    /// let unaligned: *mut u8 = ptr::without_provenance_mut(0x1001);
     ///
     /// // i32 has at least 2-byte alignment, so this will fail
     /// assert!(unaligned.try_cast_aligned::<i32>().is_none());

library/core/src/ptr/non_null.rs

@@ -498,15 +498,16 @@ impl<T: ?Sized> NonNull<T> {
     /// # Examples
     ///
     /// ```rust
-    /// #![feature(pointer_try_cast_aligned)]
+    /// #![feature(pointer_try_cast_aligned, nonnull_provenance)]
+    /// use std::num::NonZero;
     /// use std::ptr::NonNull;
     ///
-    /// let aligned: NonNull<u8> = NonNull::new(0x1000 as _).unwrap();
+    /// let aligned: NonNull<u8> = NonNull::without_provenance(NonZero::new(0x1000).unwrap());
     ///
     /// // i32 has at most 4-byte alignment, so this will succeed
     /// assert!(aligned.try_cast_aligned::<i32>().is_some());
     ///
-    /// let unaligned: NonNull<u8> = NonNull::new(0x1001 as _).unwrap();
+    /// let unaligned: NonNull<u8> = NonNull::without_provenance(NonZero::new(0x1001).unwrap());
     ///
     /// // i32 has at least 2-byte alignment, so this will fail
     /// assert!(unaligned.try_cast_aligned::<i32>().is_none());