feat(support): add start to StringHelper (#713)

Co-authored-by: Enzo Innocenzi <enzo@innocenzi.dev>
tempestphp · Nov 10, 2024 · f719c20 · f719c20
1 parent f3054f9
commit f719c20
Show file tree

Hide file tree

Showing 2 changed files with 16 additions and 0 deletions.
diff --git a/src/Tempest/Support/src/StringHelper.php b/src/Tempest/Support/src/StringHelper.php
@@ -182,6 +182,16 @@ public function finish(string $cap): self
         );
     }
 
+    /**
+     * Prefixes the instance with the given string.
+     */
+    public function start(string $prefix): self
+    {
+        return new self(
+            $prefix.preg_replace('/^(?:'.preg_quote($prefix, '/').')+/u', replacement: '', subject: $this->string)
+        );
+    }
+
     /**
      * Returns the remainder of the string after the first occurrence of the given value.
      */

diff --git a/src/Tempest/Support/tests/StringHelperTest.php b/src/Tempest/Support/tests/StringHelperTest.php
@@ -475,4 +475,10 @@ public function test_unwrap(): void
         $this->assertSame('value', str('value]')->unwrap('[', ']', strict: false)->toString());
         $this->assertSame('Scott', str('Scott Kennedy')->unwrap(before: 'Leon ', after: ' Kennedy', strict: false)->toString());
     }
+
+    public function test_start(): void
+    {
+        $this->assertSame('Leon Scott Kennedy', str('Scott Kennedy')->start('Leon ')->toString());
+        $this->assertSame('Leon Scott Kennedy', str('Leon Scott Kennedy')->start('Leon ')->toString());
+    }
 }