[String] Add the reverse method

Author: fancyweb

AbstractString.php

@@ -467,6 +467,11 @@ abstract public function replace(string $from, string $to): self;
      */
     abstract public function replaceMatches(string $fromRegexp, $to): self;
 
+    /**
+     * @return static
+     */
+    abstract public function reverse(): self;
+
     /**
      * @return static
      */

AbstractUnicodeString.php

@@ -342,6 +342,17 @@ public function replaceMatches(string $fromRegexp, $to): parent
         return $str;
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public function reverse(): parent
+    {
+        $str = clone $this;
+        $str->string = implode('', array_reverse(preg_split('/(\X)/u', $str->string, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY)));
+
+        return $str;
+    }
+
     public function snake(): parent
     {
         $str = $this->camel()->title();

ByteString.php

@@ -303,6 +303,17 @@ public function replaceMatches(string $fromRegexp, $to): parent
         return $str;
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public function reverse(): parent
+    {
+        $str = clone $this;
+        $str->string = strrev($str->string);
+
+        return $str;
+    }
+
     public function slice(int $start = 0, int $length = null): parent
     {
         $str = clone $this;

CHANGELOG.md

@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+5.1.0
+-----
+
+ * Added the `AbstractString::reverse()` method.
+
 5.0.0
 -----
 

Tests/AbstractAsciiTestCase.php

@@ -1377,4 +1377,23 @@ public function testToString()
 
         self::assertSame('foobar', $instance->toString());
     }
+
+    /**
+     * @dataProvider provideReverse
+     */
+    public function testReverse(string $expected, string $origin)
+    {
+        $instance = static::createFromString($origin)->reverse();
+
+        $this->assertEquals(static::createFromString($expected), $instance);
+    }
+
+    public static function provideReverse()
+    {
+        return [
+            ['', ''],
+            ['oof', 'foo'],
+            ["\n!!!\tTAERG SI     ynofmyS    ", "    Symfony     IS GREAT\t!!!\n"],
+        ];
+    }
 }

Tests/AbstractUnicodeTestCase.php

@@ -568,4 +568,16 @@ public static function providePadStart(): array
             ]
         );
     }
+
+    public static function provideReverse()
+    {
+        return array_merge(
+            parent::provideReverse(),
+            [
+                ['äuß⭐erst', 'tsre⭐ßuä'],
+                ['漢字ーユニコードéèΣσς', 'ςσΣèéドーコニユー字漢'],
+                ['नमस्ते', 'तेस्मन'],
+            ]
+        );
+    }
 }