feat: add Str::doesntContain() method and supporting tests (#53035)

Author: sts-ryan-holton

src/Illuminate/Support/Str.php

@@ -328,6 +328,19 @@ public static function containsAll($haystack, $needles, $ignoreCase = false)
         return true;
     }
 
+    /**
+     * Determine if a given string doesn't contain a given substring.
+     *
+     * @param  string  $haystack
+     * @param  string|iterable<string>  $needles
+     * @param  bool  $ignoreCase
+     * @return bool
+     */
+    public static function doesntContain($haystack, $needles, $ignoreCase = false)
+    {
+        return ! static::contains($haystack, $needles, $ignoreCase);
+    }
+
     /**
      * Convert the case of a string.
      *

tests/Support/SupportStrTest.php

@@ -377,6 +377,12 @@ public function testStrContainsAll($haystack, $needles, $expected, $ignoreCase =
         $this->assertEquals($expected, Str::containsAll($haystack, $needles, $ignoreCase));
     }
 
+    #[DataProvider('strDoesntContainProvider')]
+    public function testStrDoesntContain($haystack, $needles, $expected, $ignoreCase = false)
+    {
+        $this->assertEquals($expected, Str::doesntContain($haystack, $needles, $ignoreCase));
+    }
+
     public function testConvertCase()
     {
         // Upper Case Conversion
@@ -1285,6 +1291,13 @@ public static function strContainsAllProvider()
         ];
     }
 
+    public static function strDoesntContainProvider()
+    {
+        return [
+            ['Tar', 'ylo', true, true],
+        ];
+    }
+
     public function testMarkdown()
     {
         $this->assertSame("<p><em>hello world</em></p>\n", Str::markdown('*hello world*'));