Replace regex operator ~= with =~ (#1239)

guykogus · web-flow · commit ac4aff4f612d · 2025-06-10T14:40:05.000-03:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,6 +3,10 @@
 The changelog for **SwifterSwift**. Also see the [releases](https://github.com/SwifterSwift/SwifterSwift/releases) on GitHub.
 
 ## Upcoming Release
+### Breaking Change
+- **String**
+  - Replaced `~=` operator overload with `=~` to fix breaking `switch` statements and align with other languages. [#1239](https://github.com/SwifterSwift/SwifterSwift/pull/1239) by [guykogus](https://github.com/guykogus)
+
 ### Added
 - **UIView**
   - Added `addBottomSeparator(color:height:spacing:)` method to easily insert a bottom line to a view. 🚀 [#1234](https://github.com/SwifterSwift/SwifterSwift/pull/1234) by [sangjin](https://github.com/SsangG77)
diff --git a/Sources/SwifterSwift/SwiftStdlib/StringExtensions.swift b/Sources/SwifterSwift/SwiftStdlib/StringExtensions.swift
@@ -1080,8 +1080,8 @@ public extension String {
     ///   - lhs: String to check on regex pattern.
     ///   - rhs: Regex pattern to match against.
     /// - Returns: true if string matches the pattern.
-    static func ~= (lhs: String, rhs: String) -> Bool {
-        return rhs.range(of: lhs, options: .regularExpression) != nil
+    static func =~ (lhs: String, rhs: String) -> Bool {
+        return lhs.range(of: rhs, options: .regularExpression) != nil
     }
     #endif
 
@@ -1092,9 +1092,9 @@ public extension String {
     ///   - lhs: String to check on regex.
     ///   - rhs: Regex to match against.
     /// - Returns: `true` if there is at least one match for the regex in the string.
-    static func ~= (lhs: NSRegularExpression, rhs: String) -> Bool {
-        let range = NSRange(rhs.startIndex..<rhs.endIndex, in: rhs)
-        return lhs.firstMatch(in: rhs, range: range) != nil
+    static func =~ (lhs: String, rhs: NSRegularExpression) -> Bool {
+        let range = NSRange(lhs.startIndex..<lhs.endIndex, in: lhs)
+        return rhs.firstMatch(in: lhs, range: range) != nil
     }
     #endif
 
@@ -1411,3 +1411,9 @@ public extension String {
 }
 
 #endif
+
+// MARK: Operators
+
+#if canImport(Foundation)
+infix operator =~: ComparisonPrecedence
+#endif
diff --git a/Tests/SwiftStdlibTests/StringExtensionsTests.swift b/Tests/SwiftStdlibTests/StringExtensionsTests.swift
@@ -620,32 +620,22 @@ final class StringExtensionsTests: XCTestCase {
 
     #if canImport(Foundation)
     func testPatternMatchOperator() {
-        XCTAssert("\\d{3}" ~= "123")
-        XCTAssertFalse("\\d{3}" ~= "dasda")
-        XCTAssertFalse(emailPattern ~= "notanemail.com")
-        XCTAssert(emailPattern ~= "email@mail.com")
-        XCTAssert("[a-z]at" ~= "hat")
-        XCTAssertFalse("[a-z]at" ~= "")
-        XCTAssert("[a-z]*" ~= "")
-        XCTAssertFalse("[0-9]+" ~= "")
-
-        // https://github.com/SwifterSwift/SwifterSwift/issues/1109
-        let codeString = "0"
-        switch codeString {
-        case "101":
-            XCTAssert(codeString == "101")
-        case "0":
-            XCTAssert(codeString == "0")
-        default:
-            XCTFail("Switch string value, not matching the correct result.")
-        }
+        XCTAssert("123" =~ "\\d{3}")
+        XCTAssertFalse("dasda" =~ "\\d{3}")
+        XCTAssertFalse("notanemail.com" =~ emailPattern)
+        XCTAssert("email@mail.com" =~ emailPattern)
+        XCTAssert("hat" =~ "[a-z]at")
+        XCTAssertFalse("" =~ "[a-z]at")
+        XCTAssert("" =~ "[a-z]*")
+        XCTAssert("" =~ "[a-z]*")
+        XCTAssertFalse("" =~ "[0-9]+")
     }
     #endif
 
     func testRegexMatchOperator() throws {
         let regex = try NSRegularExpression(pattern: "\\d{3}")
-        XCTAssert(regex ~= "123")
-        XCTAssertFalse(regex ~= "abc")
+        XCTAssert("123" =~ regex)
+        XCTAssertFalse("abc" =~ regex)
     }
 
     func testPadStart() {
