feat(strings): add new method wrap

Author: Awilum

src/Strings.php

@@ -1892,6 +1892,24 @@ public function format(...$args): self
         return $this;
     }
 
+    /**
+     * Wrap the string with the given strings.
+     *
+     * @param  string       $before String to wrap before.
+     * @param  string|null  $after  String to wrap after.
+     *
+     * @return self Returns instance of the Strings class.
+     *
+     * @access public
+     */
+    public function wrap($before, $after = null)
+    {
+        $this->string = $before . $this->string . ($after ??= $before);
+        
+        return $this;
+    }
+
+
     /**
      * Returns true if the string matches a given pattern.
      *

tests/StringsTest.php

@@ -510,6 +510,11 @@
     $this->assertEquals('test - FÒÔ BÀŘS', $strings2->toString());
 });
 
+test('test wrap() method', function(): void {
+    $this->assertEquals('<< Stranger Things >>', Strings::create('Stranger Things')->wrap('<< ', ' >>')->toString());
+    $this->assertEquals('#Stranger Things#', Strings::create('Stranger Things')->wrap('#')->toString());
+});
+
 test('test replaceSubstr() method', function (): void {
     $this->assertEquals('19-84', Strings::create('1984')->replaceSubstr('-', 2, 0)->toString());
     $this->assertEquals('fòô bàř bàz', Strings::create('fòô bàz')->replaceSubstr('bàř ', 4, 0)->toString());