Guarantee the memory layout of Cell

rust-lang · Jan 24, 2023 · 660d985 · 660d985
1 parent ae4d89d
commit 660d985
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/library/core/src/cell.rs b/library/core/src/cell.rs
@@ -209,6 +209,12 @@ pub use once::OnceCell;
 
 /// A mutable memory location.
 ///
+/// # Memory layout
+///
+/// `Cell<T>` has the same [memory layout and caveats as
+/// `UnsafeCell<T>`](UnsafeCell#memory-layout). In particular, this means that
+/// `Cell<T>` has the same in-memory representation as its inner type `T`.
+///
 /// # Examples
 ///
 /// In this example, you can see that `Cell<T>` enables mutation inside an