feat(strings): add new methods whenStartsWith and whenIsUuid

Author: Awilum

src/Strings.php

@@ -1801,6 +1801,37 @@ public function whenIsAscii($callback, $default = null)
         return $this->when($this->isAscii(), $callback, $default);
     }
 
+    /**
+     * Execute the given callback if the string is a valid UUID.
+     *
+     * @param callable      $callback Callback function.
+     * @param callable      $default  Callback function.
+     * 
+     * @return self Returns instance of the Strings class.
+     *
+     * @access public
+     */
+    public function whenIsUuid($callback, $default = null)
+    {
+        return $this->when($this->isUuid(), $callback, $default);
+    }
+
+    /**
+     * Execute the given callback if the string starts with a given substring.
+     *
+     * @param string|string[]  $needles  The string to find in haystack.
+     * @param callable         $callback Callback function.
+     * @param callable         $default  Callback function.
+     * 
+     * @return self Returns instance of the Strings class.
+     *
+     * @access public
+     */
+    public function whenStartsWith($needles, $callback, $default = null)
+    {
+        return $this->when($this->startsWith($needles), $callback, $default);
+    }
+
     /**
      * Apply the callback if the given "value" is (or resolves to) falsy.
      *

tests/StringsTest.php

@@ -478,6 +478,22 @@
     $this->assertEquals('# EL', $strings->toString());
 });
 
+test('test whenIsUuid() method', function (): void {
+    $strings = new Strings('f47ac10b-58cc-4372-a567-0e02b2c3d479');
+    $strings->whenIsUuid(function ($strings) {
+        return $strings->prepend('uuid: ');
+    });
+    $this->assertEquals('uuid: f47ac10b-58cc-4372-a567-0e02b2c3d479', $strings->toString());
+});
+
+test('test whenStartsWith() method', function (): void {
+    $strings = new Strings('maxine mayfield');
+    $strings->whenStartsWith('maxine', function ($strings) {
+        return $strings->headline();
+    });
+    $this->assertEquals('Maxine Mayfield', $strings->toString());
+});
+
 test('test unless() method', function (): void {
     $strings = new Strings('Fòô');
     $strings->unless(false, function ($strings) {