[stdlib] UnsafeRawBufferPointer: new interactions with noncopyable types

Author: lorentey

stdlib/public/core/UnsafeRawBufferPointer.swift.gyb

@@ -120,6 +120,9 @@ public struct Unsafe${Mutable}RawBufferPointer {
   }
 }
 
+@available(*, unavailable)
+extension Unsafe${Mutable}RawBufferPointer: Sendable {}
+
 %if not mutable:
 extension UnsafeRawBufferPointer {
   /// An iterator over the bytes viewed by a raw buffer pointer.
@@ -136,6 +139,9 @@ extension UnsafeRawBufferPointer {
   }
 }
 
+@available(*, unavailable)
+extension UnsafeRawBufferPointer.Iterator: Sendable { }
+
 extension UnsafeRawBufferPointer.Iterator: IteratorProtocol, Sequence {
   /// Advances to the next byte and returns it, or `nil` if no next byte
   /// exists.
@@ -400,6 +406,9 @@ extension Unsafe${Mutable}RawBufferPointer {
     return baseAddress!.load(fromByteOffset: offset, as: T.self)
   }
 
+  // FIXME(NCG): Add a consuming analogue of `load`, like `move(fromByteOffset:as:_:)`
+  // FIXME(NCG): Add a borrow analogue of `load`, like `withBorrow(fromByteOffset:as:_:)`
+
   /// Returns a new instance of the given type, constructed from the raw memory
   /// at the specified offset.
   ///
@@ -431,7 +440,6 @@ extension Unsafe${Mutable}RawBufferPointer {
   /// - Returns: A new instance of type `T`, copied from the buffer pointer's
   ///   memory.
 #if $BitwiseCopyable
-  @inlinable
   @_alwaysEmitIntoClient
   public func loadUnaligned<T : _BitwiseCopyable>(
     fromByteOffset offset: Int = 0,
@@ -443,7 +451,7 @@ extension Unsafe${Mutable}RawBufferPointer {
     return baseAddress!.loadUnaligned(fromByteOffset: offset, as: T.self)
   }
 #endif
-  @inlinable
+
   @_alwaysEmitIntoClient
   public func loadUnaligned<T>(
     fromByteOffset offset: Int = 0,
@@ -508,7 +516,7 @@ extension Unsafe${Mutable}RawBufferPointer {
   // This unavailable implementation uses the expected mangled name
   // of `storeBytes<T>(of:toByteOffset:as:)`, and provides an entry point for
   // any binary linked against the stdlib binary for Swift 5.6 and older.
-  @available(*, unavailable)
+  @_spi(SwiftStdlibLegacyABI) @available(swift, obsoleted: 2)
   @_silgen_name("$sSw10storeBytes2of12toByteOffset2asyx_SixmtlF")
   @usableFromInline func _legacy_se0349_storeBytes<T>(
     of value: T, toByteOffset offset: Int = 0, as type: T.Type
@@ -620,7 +628,8 @@ extension Unsafe${Mutable}RawBufferPointer {
   /// - Parameter buffer: The typed buffer to convert to a raw buffer. The
   ///   buffer's type `T` must be a trivial type.
   @inlinable
-  public init<T>(_ buffer: UnsafeMutableBufferPointer<T>) {
+  @_preInverseGenerics
+  public init<T: ~Copyable>(_ buffer: UnsafeMutableBufferPointer<T>) {
     self.init(start: buffer.baseAddress,
       count: buffer.count * MemoryLayout<T>.stride)
   }
@@ -631,7 +640,8 @@ extension Unsafe${Mutable}RawBufferPointer {
   /// - Parameter buffer: The typed buffer to convert to a raw buffer. The
   ///   buffer's type `T` must be a trivial type.
   @inlinable
-  public init<T>(_ buffer: UnsafeBufferPointer<T>) {
+  @_preInverseGenerics
+  public init<T: ~Copyable>(_ buffer: UnsafeBufferPointer<T>) {
     self.init(start: buffer.baseAddress,
       count: buffer.count * MemoryLayout<T>.stride)
   }
@@ -934,7 +944,7 @@ extension Unsafe${Mutable}RawBufferPointer {
   @discardableResult
   @inlinable
   @_alwaysEmitIntoClient
-  public func moveInitializeMemory<T>(
+  public func moveInitializeMemory<T: ~Copyable>(
     as type: T.Type,
     fromContentsOf source: UnsafeMutableBufferPointer<T>
   ) -> UnsafeMutableBufferPointer<T> {
@@ -985,7 +995,6 @@ extension Unsafe${Mutable}RawBufferPointer {
   ///     The returned buffer references memory starting at the same
   ///     base address as this buffer, and its count is equal to `source.count`.
   @discardableResult
-  @inlinable
   @_alwaysEmitIntoClient
   public func moveInitializeMemory<T>(
     as type: T.Type,
@@ -997,8 +1006,8 @@ extension Unsafe${Mutable}RawBufferPointer {
 
   %  end # mutable
 
-  /// Binds this buffer’s memory to the specified type and returns a typed buffer 
-  /// of the bound memory.
+  /// Binds this buffer’s memory to the specified type and returns a typed
+  /// buffer of the bound memory.
   ///
   /// Use the `bindMemory(to:)` method to bind the memory referenced
   /// by this buffer to the type `T`. The memory must be uninitialized or
@@ -1015,9 +1024,11 @@ extension Unsafe${Mutable}RawBufferPointer {
   ///   region is bound to `T`, but has not been modified in any other way.
   ///   The typed buffer references `self.count / MemoryLayout<T>.stride`
   ///   instances of `T`.
+  @inlinable
   @_transparent
+  @_preInverseGenerics
   @discardableResult
-  public func bindMemory<T>(
+  public func bindMemory<T: ~Copyable>(
     to type: T.Type
   ) -> Unsafe${Mutable}BufferPointer<T> {
     guard let base = _position else {
@@ -1076,7 +1087,7 @@ extension Unsafe${Mutable}RawBufferPointer {
   /// - Returns: The return value, if any, of the `body` closure parameter.
   @inlinable
   @_alwaysEmitIntoClient
-  public func withMemoryRebound<T, Result, E: Error>(
+  public func withMemoryRebound<T: ~Copyable, Result: ~Copyable, E: Error>(
     to type: T.Type,
     _ body: (_ buffer: Unsafe${Mutable}BufferPointer<T>) throws(E) -> Result
   ) throws(E) -> Result {
@@ -1114,7 +1125,7 @@ extension Unsafe${Mutable}RawBufferPointer {
   /// - Returns: A typed pointer to the same memory as this raw pointer.
   @inlinable
   @_alwaysEmitIntoClient
-  public func assumingMemoryBound<T>(
+  public func assumingMemoryBound<T: ~Copyable>(
     to: T.Type
   ) -> Unsafe${Mutable}BufferPointer<T> {
     guard let s = _position else {
@@ -1130,7 +1141,7 @@ extension Unsafe${Mutable}RawBufferPointer {
 %  if Mutable:
   @inlinable
   @_alwaysEmitIntoClient
-  public func withContiguousMutableStorageIfAvailable<R>(
+  public func withContiguousMutableStorageIfAvailable<R: ~Copyable>(
     _ body: (inout UnsafeMutableBufferPointer<Element>) throws -> R
   ) rethrows -> R? {
     #if $TypedThrows
@@ -1152,7 +1163,7 @@ extension Unsafe${Mutable}RawBufferPointer {
 %  end
   @inlinable
   @_alwaysEmitIntoClient
-  public func withContiguousStorageIfAvailable<R>(
+  public func withContiguousStorageIfAvailable<R: ~Copyable>(
     _ body: (UnsafeBufferPointer<Element>) throws -> R
   ) rethrows -> R? {
     #if $TypedThrows
@@ -1216,7 +1227,6 @@ extension ${Self} {
 ///     function. The buffer pointer argument is valid only for the duration
 ///     of the closure's execution.
 /// - Returns: The return value, if any, of the `body` closure.
-@inlinable
 @_alwaysEmitIntoClient
 public func withUnsafeMutableBytes<T, E: Error, Result>(
   of value: inout T,
@@ -1281,7 +1291,6 @@ public func _withUnprotectedUnsafeMutableBytes<T, E: Error, Result>(
 ///     If you want to mutate a value by writing through a pointer, use
 ///     `withUnsafeMutableBytes(of:_:)` instead.
 /// - Returns: The return value, if any, of the `body` closure.
-@inlinable
 @_alwaysEmitIntoClient
 public func withUnsafeBytes<T, E: Error, Result>(
   of value: inout T,
@@ -1341,7 +1350,6 @@ public func _withUnprotectedUnsafeBytes<T, E: Error, Result>(
 ///     If you want to mutate a value by writing through a pointer, use
 ///     `withUnsafeMutableBytes(of:_:)` instead.
 /// - Returns: The return value, if any, of the `body` closure.
-@inlinable
 @_alwaysEmitIntoClient
 public func withUnsafeBytes<T, E: Error, Result>(
   of value: T,
@@ -1383,14 +1391,6 @@ public func _withUnprotectedUnsafeBytes<T, E: Error, Result>(
   return try body(buffer)
 }
 
-@available(*, unavailable)
-extension UnsafeRawBufferPointer: Sendable { }
-@available(*, unavailable)
-extension UnsafeRawBufferPointer.Iterator: Sendable { }
-@available(*, unavailable)
-extension UnsafeMutableRawBufferPointer: Sendable { }
-
-
 // ${'Local Variables'}:
 // eval: (read-only-mode 1)
 // End: