From af69f157129e154f050a224ba384703e57115032 Mon Sep 17 00:00:00 2001
From: Orson Peters <orsonpeters@gmail.com>
Date: Tue, 6 Jan 2026 22:09:11 +0100
Subject: [PATCH 1/2] Add AtomicPtr::null

---
 library/core/src/sync/atomic.rs | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/library/core/src/sync/atomic.rs b/library/core/src/sync/atomic.rs
index 1eae06ebd33e7..c675fd1381d85 100644
--- a/library/core/src/sync/atomic.rs
+++ b/library/core/src/sync/atomic.rs
@@ -1550,6 +1550,23 @@ impl<T> AtomicPtr<T> {
         unsafe { &*ptr.cast() }
     }
 
+    /// Creates a new `AtomicPtr` initialized with a null pointer.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use std::sync::atomic::{AtomicPtr, Ordering};
+    ///
+    /// let atomic_ptr = AtomicPtr::<()>::null();
+    /// assert!(atomic_ptr.load(Ordering::Relaxed).is_null());
+    /// ```
+    #[inline]
+    #[must_use]
+    #[unstable(feature = "atomic_ptr_null", issue = "150733")]
+    pub const fn null() -> AtomicPtr<T> {
+        AtomicPtr::new(crate::ptr::null_mut())
+    }
+
     /// Returns a mutable reference to the underlying pointer.
     ///
     /// This is safe because the mutable reference guarantees that no other threads are

From fff9c623bfc75bce9f9e5c64ed67d9b04ea655c1 Mon Sep 17 00:00:00 2001
From: Orson Peters <orsonpeters@gmail.com>
Date: Tue, 6 Jan 2026 23:38:31 +0100
Subject: [PATCH 2/2] Add feature to doc example

---
 library/core/src/sync/atomic.rs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/library/core/src/sync/atomic.rs b/library/core/src/sync/atomic.rs
index c675fd1381d85..22f46ec385ced 100644
--- a/library/core/src/sync/atomic.rs
+++ b/library/core/src/sync/atomic.rs
@@ -1555,6 +1555,7 @@ impl<T> AtomicPtr<T> {
     /// # Examples
     ///
     /// ```
+    /// #![feature(atomic_ptr_null)]
     /// use std::sync::atomic::{AtomicPtr, Ordering};
     ///
     /// let atomic_ptr = AtomicPtr::<()>::null();