[stdlib] array identical

Author: vanvoorden

stdlib/public/core/Array.swift

@@ -2136,3 +2136,23 @@ internal struct _ArrayAnyHashableBox<Element: Hashable>
 }
 
 extension Array: @unchecked Sendable where Element: Sendable { }
+
+extension Array {
+  /// Returns a boolean value indicating whether this array is identical to
+  /// `other`.
+  ///
+  /// Two array values are identical if there is no way to distinguish between
+  /// them.
+  ///
+  /// Comparing arrays this way includes comparing (normally) hidden
+  /// implementation details such as the memory location of any underlying
+  /// array storage object. Therefore, identical arrays are guaranteed to
+  /// compare equal with `==`, but not all equal arrays are considered
+  /// identical.
+  ///
+  /// - Performance: O(1)
+  @backDeployed(before: SwiftStdlib 6.3)
+  public func isIdentical(to other: Self) -> Bool {
+    self._buffer.identity == other._buffer.identity
+  }
+}

stdlib/public/core/ArraySlice.swift

@@ -1586,3 +1586,23 @@ extension ArraySlice {
   }
 }
 #endif
+
+extension ArraySlice {
+  /// Returns a boolean value indicating whether this array is identical to
+  /// `other`.
+  ///
+  /// Two array values are identical if there is no way to distinguish between
+  /// them.
+  ///
+  /// Comparing arrays this way includes comparing (normally) hidden
+  /// implementation details such as the memory location of any underlying
+  /// array storage object. Therefore, identical arrays are guaranteed to
+  /// compare equal with `==`, but not all equal arrays are considered
+  /// identical.
+  ///
+  /// - Performance: O(1)
+  @backDeployed(before: SwiftStdlib 6.3)
+  public func isIdentical(to other: Self) -> Bool {
+    self._buffer.identity == other._buffer.identity
+  }
+}

stdlib/public/core/ContiguousArray.swift

@@ -1495,3 +1495,23 @@ extension ContiguousArray {
 
 extension ContiguousArray: @unchecked Sendable
   where Element: Sendable { }
+
+extension ContiguousArray {
+  /// Returns a boolean value indicating whether this array is identical to
+  /// `other`.
+  ///
+  /// Two array values are identical if there is no way to distinguish between
+  /// them.
+  ///
+  /// Comparing arrays this way includes comparing (normally) hidden
+  /// implementation details such as the memory location of any underlying
+  /// array storage object. Therefore, identical arrays are guaranteed to
+  /// compare equal with `==`, but not all equal arrays are considered
+  /// identical.
+  ///
+  /// - Performance: O(1)
+  @backDeployed(before: SwiftStdlib 6.3)
+  public func isIdentical(to other: Self) -> Bool {
+    self._buffer.identity == other._buffer.identity
+  }
+}