[5.1] Restore elementwise min/max on SIMD (#24772)

* Restore elementwise min/max on SIMD, with explicit naming. (#24136)

* Restore elementwise min/max on SIMD, but as statics instead of free functions.

Having these as free functions causes expression too complex issues due to overload vis-a-vis min<Collection>. There are (at least) three plausible solutions:

1. Fix the typechecker. This is infeasable in the short term; or more precisely, we do not know how much work is involved.

2. Give these operations different names. Candidates discussed with core team include "pointwiseMin", "elementwiseMin", "lanewiseMin"; these all suffer from the flaw that when someone writes "min" in a SIMD context, they are essentially always looking for either the horizontal minimum (reduction) on a single vector or--more often--the lanewise minimum of two vectors (this operation). It would be odd to give the operation that people actually want the unnecessarily verbose name.

3. Make these operations static; this is, in effect, a different name, but it's one which frequently allows eliding the qualifier:

  let x = v + .min(v, w)

This isn't perfect; you will still need to spell out SIMD4.min( ) fairly often, but that's more concise than any of the proposed alternatives, and at least allows elision some of the time. Also, if you squint, you can pretend that the "." prefix is like ".<" and ".&" and indicates lanewise operation.

* Really remove static min and max on simd. One slipped through. (#24283)

Author: stephentyrone

stdlib/public/core/SIMDVector.swift

@@ -467,17 +467,15 @@ extension SIMD where Scalar: Comparable {
     return lhs .> Self(repeating: rhs)
   }
 
-  /*  Temporarily removed pending plan for Swift.min / Swift.max
   @_alwaysEmitIntoClient
   public mutating func clamp(lowerBound: Self, upperBound: Self) {
     self = self.clamped(lowerBound: lowerBound, upperBound: upperBound)
   }
 
   @_alwaysEmitIntoClient
   public func clamped(lowerBound: Self, upperBound: Self) -> Self {
-    return Swift.min(upperBound, Swift.max(lowerBound, self))
+    return pointwiseMin(upperBound, pointwiseMax(lowerBound, self))
   }
-  */
 }
 
 extension SIMD where Scalar: FixedWidthInteger {
@@ -550,6 +548,16 @@ extension SIMD where Scalar: FloatingPoint {
   public static var one: Self {
     return Self(repeating: 1)
   }
+  
+  @_alwaysEmitIntoClient
+  public mutating func clamp(lowerBound: Self, upperBound: Self) {
+    self = self.clamped(lowerBound: lowerBound, upperBound: upperBound)
+  }
+
+  @_alwaysEmitIntoClient
+  public func clamped(lowerBound: Self, upperBound: Self) -> Self {
+    return pointwiseMin(upperBound, pointwiseMax(lowerBound, self))
+  }
 }
 
 extension SIMD
@@ -1343,34 +1351,30 @@ public func all<Storage>(_ mask: SIMDMask<Storage>) -> Bool {
   return mask._storage.max() < 0
 }
 
-/*
-Temporarily removed while we investigate compile-time regressions caused by
-introducing these global functions.
- 
 /// The lanewise minimum of two vectors.
 ///
 /// Each element of the result is the minimum of the corresponding elements
 /// of the inputs.
 @_alwaysEmitIntoClient
-public func min<V>(_ lhs: V, _ rhs: V) -> V
-where V: SIMD, V.Scalar: Comparable {
-  var result = V()
+public func pointwiseMin<T>(_ a: T, _ b: T) -> T
+where T: SIMD, T.Scalar: Comparable {
+  var result = T()
   for i in result.indices {
-    result[i] = min(lhs[i], rhs[i])
+    result[i] = min(a[i], b[i])
   }
   return result
 }
 
 /// The lanewise maximum of two vectors.
 ///
-/// Each element of the result is the maximum of the corresponding elements
+/// Each element of the result is the minimum of the corresponding elements
 /// of the inputs.
 @_alwaysEmitIntoClient
-public func max<V>(_ lhs: V, _ rhs: V) -> V
-where V: SIMD, V.Scalar: Comparable {
-  var result = V()
+public func pointwiseMax<T>(_ a: T, _ b: T) -> T
+where T: SIMD, T.Scalar: Comparable {
+  var result = T()
   for i in result.indices {
-    result[i] = max(lhs[i], rhs[i])
+    result[i] = max(a[i], b[i])
   }
   return result
 }
@@ -1381,11 +1385,11 @@ where V: SIMD, V.Scalar: Comparable {
 /// Each element of the result is the minimum of the corresponding elements
 /// of the inputs.
 @_alwaysEmitIntoClient
-public func min<V>(_ lhs: V, _ rhs: V) -> V
-where V: SIMD, V.Scalar: FloatingPoint {
-  var result = V()
+public func pointwiseMin<T>(_ a: T, _ b: T) -> T
+where T: SIMD, T.Scalar: FloatingPoint {
+  var result = T()
   for i in result.indices {
-    result[i] = V.Scalar.minimum(lhs[i], rhs[i])
+    result[i] = T.Scalar.minimum(a[i], b[i])
   }
   return result
 }
@@ -1395,12 +1399,11 @@ where V: SIMD, V.Scalar: FloatingPoint {
 /// Each element of the result is the maximum of the corresponding elements
 /// of the inputs.
 @_alwaysEmitIntoClient
-public func max<V>(_ lhs: V, _ rhs: V) -> V
-where V: SIMD, V.Scalar: FloatingPoint {
-  var result = V()
+public func pointwiseMax<T>(_ a: T, _ b: T) -> T
+where T: SIMD, T.Scalar: FloatingPoint {
+  var result = T()
   for i in result.indices {
-    result[i] = V.Scalar.maximum(lhs[i], rhs[i])
+    result[i] = T.Scalar.maximum(a[i], b[i])
   }
   return result
 }
-*/