Fix RangeReplaceableCollection conformance for latest Swift version (#9)

* Fix RangeReplaceableCollection conformance for latest Swift version

* Add documentation to new replaceSubrange implementations and refactor from fatalError to precondition

* Fix incorrect preconditions

Co-authored-by: Christian Treffs <[email protected]>

Author: stackotter

Sources/FirebladeMath/Matrix/MatrixStorage.swift

@@ -27,6 +27,19 @@ extension Storage4x4Protocol where Element == Value, Index == Int {
     public func index(after i: Int) -> Int { i + 1 }
 }
 
+extension Storage4x4Protocol {
+    /// Replaces a subrange of the matrix's underlying storage.
+    /// - Precondition: `subrange` and `newElements` must be the same length because if they don't
+    ///   that doesn't make any sense in relation to matrices.
+    public mutating func replaceSubrange<C>(_ subrange: Range<Int>, with newElements: C) where C : Collection, Value == C.Element {
+        precondition(subrange.count == newElements.count, "newElements must be the same length as subrange")
+
+        for (i, element) in zip(subrange, newElements) {
+            self[i] = element
+        }
+    }
+}
+
 public protocol Storage3x3Protocol: RandomAccessCollection, MutableCollection, RangeReplaceableCollection, Equatable {
     associatedtype Value: StorageScalar
     // associatedtype _Storage4x4: Storage4x4Protocol where _Storage4x4.Value == Value
@@ -47,3 +60,16 @@ extension Storage3x3Protocol where Element == Value, Index == Int {
 
     public func index(after i: Int) -> Int { i + 1 }
 }
+
+extension Storage3x3Protocol {
+    /// Replaces a subrange of the matrix's underlying storage.
+    /// - Precondition: `subrange` and `newElements` must be the same length because if they don't
+    ///   that doesn't make any sense in relation to matrices.
+    public mutating func replaceSubrange<C>(_ subrange: Range<Int>, with newElements: C) where C : Collection, Value == C.Element {
+        precondition(subrange.count == newElements.count, "newElements must be the same length as subrange")
+
+        for (i, element) in zip(subrange, newElements) {
+            self[i] = element
+        }
+    }
+}