prof: update some string check methods

Author: inhere

src/Str/Traits/StringCheckHelperTrait.php

@@ -19,6 +19,7 @@
 use function str_ends_with;
 use function str_starts_with;
 use function stripos;
+use function strlen;
 use function strpos;
 use function strrpos;
 use function strtolower;
@@ -276,7 +277,64 @@ public static function strrpos(string $str, string $find, int $offset = 0, strin
     }
 
     /**
-     * Assert is start withs one
+     * @param string $str
+     * @param string $needle
+     *
+     * @return bool
+     */
+    public static function startWith(string $str, string $needle): bool
+    {
+        return self::hasPrefix($str, $needle);
+    }
+
+    /**
+     * @param string $str
+     * @param string $needle
+     *
+     * @return bool
+     */
+    public static function hasPrefix(string $str, string $needle): bool
+    {
+        return str_starts_with($str, $needle);
+    }
+
+    /**
+     * @param string $str
+     * @param string $needle
+     *
+     * @return bool
+     */
+    public static function isStartWithIC(string $str, string $needle): bool
+    {
+        return self::hasPrefixIC($str, $needle);
+    }
+
+    /**
+     * @param string $str
+     * @param string $needle
+     *
+     * @return bool
+     */
+    public static function startWithIC(string $str, string $needle): bool
+    {
+        return self::hasPrefixIC($str, $needle);
+    }
+
+    /**
+     * ignore case, the passed $str ends with the $needle string
+     *
+     * @param string $str
+     * @param string $needle
+     *
+     * @return bool
+     */
+    public static function hasPrefixIC(string $str, string $needle): bool
+    {
+        return stripos($str, $needle) === 0;
+    }
+
+    /**
+     * check $str is start withs one of $needle
      *
      * @param string $str
      * @param string|array $needle
@@ -299,13 +357,13 @@ public static function isStartWiths(string $str, $needle): bool
 
     /**
      * @param string $str
-     * @param string $needle
+     * @param string|array $needle
      *
      * @return bool
      */
-    public static function hasPrefix(string $str, string $needle): bool
+    public static function startWiths(string $str, $needle): bool
     {
-        return str_starts_with($str, $needle);
+        return self::isStartWiths($str, $needle);
     }
 
     /**
@@ -320,14 +378,16 @@ public static function hasPrefixes(string $str, array $needles): bool
     }
 
     /**
+     * the passed $str ends with the $needle string
+     *
      * @param string $str
      * @param string $needle
      *
      * @return bool
      */
-    public static function isEndWiths(string $str, string $needle): bool
+    public static function hasSuffix(string $str, string $needle): bool
     {
-        return self::hasSuffix($str, $needle);
+        return str_ends_with($str, $needle);
     }
 
     /**
@@ -336,9 +396,68 @@ public static function isEndWiths(string $str, string $needle): bool
      *
      * @return bool
      */
-    public static function hasSuffix(string $str, string $needle): bool
+    public static function endWithIC(string $str, string $needle): bool
     {
-        return str_ends_with($str, $needle);
+        return self::hasSuffixIC($str, $needle);
+    }
+
+    /**
+     * ignore case, check $str is ends with the $needle string
+     *
+     * @param string $str
+     * @param string $needle
+     *
+     * @return bool
+     */
+    public static function hasSuffixIC(string $str, string $needle): bool
+    {
+        $pos = stripos($str, $needle);
+
+        return $pos !== false && $pos + strlen($needle) === strlen($str);
+    }
+
+    /**
+     * @param string $str
+     * @param string|array $needle
+     *
+     * @return bool
+     */
+    public static function endWiths(string $str, $needle): bool
+    {
+        return self::hasSuffixes($str, $needle);
+    }
+
+    /**
+     * @param string $str
+     * @param string|array $needle
+     *
+     * @return bool
+     */
+    public static function isEndWiths(string $str, $needle): bool
+    {
+        return self::hasSuffixes($str, $needle);
+    }
+
+    /**
+     * Assert is start withs one
+     *
+     * @param string $str
+     * @param string|array $needles
+     *
+     * @return bool
+     */
+    public static function hasSuffixes(string $str, $needles): bool
+    {
+        if (is_array($needles)) {
+            foreach ($needles as $needle) {
+                if (str_ends_with($str, $needle)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+
+        return str_ends_with($str, $needles);
     }
 
     /**

test/Str/StringHelperTest.php

@@ -95,11 +95,39 @@ public function testHasPrefix(): void
     {
         self::assertTrue(Str::hasPrefix('abc', 'a'));
         self::assertFalse(Str::hasPrefix('abc', 'c'));
-        self::assertTrue(Str::hasSuffix('abc', 'c'));
+        self::assertTrue(Str::endWiths('abc', 'c'));
         self::assertTrue(Str::hasSuffix('abc', 'bc'));
         self::assertFalse(Str::hasSuffix('abc', 'b'));
     }
 
+    public function testIEndWiths(): void
+    {
+        self::assertTrue(Str::endWithIC('abC', 'C'));
+        self::assertTrue(Str::endWithIC('abC', 'c'));
+        self::assertFalse(Str::endWithIC('abc', 'b'));
+        self::assertFalse(Str::hasPrefixIC('abc', 'a'));
+
+        self::assertFalse(Str::hasPrefixIC('abc', 'a'));
+    }
+
+    public function testHasPrefixIC(): void
+    {
+        $tests = [
+            ['abc', 'a', true],
+            ['23ab', 'a', false],
+        ];
+
+        foreach ($tests as [$case, $want, $yes]) {
+            if ($yes) {
+                $this->assertTrue(Str::hasPrefixIC($case, $want));
+                $this->assertTrue(Str::startWithIC($case, $want));
+                $this->assertTrue(Str::isStartWithIC($case, $want));
+            } else {
+                $this->assertFalse(Str::hasPrefixIC($case, $want));
+            }
+        }
+    }
+
     public function testStrpos(): void
     {
         $tests = [