feat: str match (#527)

Author: brendt

src/Tempest/Support/src/StringHelper.php

@@ -347,6 +347,13 @@ public function replace(string|array $search, string|array $replace): self
         return new self(str_replace($search, $replace, $this->string));
     }
 
+    public function match(string $regex): array
+    {
+        preg_match($regex, $this->string, $matches);
+
+        return $matches;
+    }
+
     public function ld(mixed ...$ld): void
     {
         ld($this->string, ...$ld);

src/Tempest/Support/tests/StringHelperTest.php

@@ -260,4 +260,11 @@ public function test_prepend(): void
         $this->assertTrue(str('bar')->prepend('foo')->equals('foobar'));
         $this->assertTrue(str('baz')->prepend('bar', 'foo')->equals('barfoobaz'));
     }
+
+    public function test_match(): void
+    {
+        $match = str('10-abc')->match('/(?<id>\d+-)/')['id'];
+
+        $this->assertSame('10-', $match);
+    }
 }