symfony · nicolas-grekas · Dec 26, 2019 · Dec 23, 2019
diff --git a/src/Symfony/Component/String/AbstractString.php b/src/Symfony/Component/String/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
     */

diff --git a/src/Symfony/Component/String/AbstractUnicodeString.php b/src/Symfony/Component/String/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();

diff --git a/src/Symfony/Component/String/ByteString.php b/src/Symfony/Component/String/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;

diff --git a/src/Symfony/Component/String/CHANGELOG.md b/src/Symfony/Component/String/CHANGELOG.md
@@ -1,6 +1,11 @@
 CHANGELOG
 =========

+5.1.0
+-----
+
+ * Added the `AbstractString::reverse()` method.
+
 5.0.0
 -----


diff --git a/src/Symfony/Component/String/Tests/AbstractAsciiTestCase.php b/src/Symfony/Component/String/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"],
+        ];
+    }
 }
diff --git a/src/Symfony/Component/String/Tests/AbstractUnicodeTestCase.php b/src/Symfony/Component/String/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ä'],
+                ['漢字ーユニコードéèΣσς', 'ςσΣèéドーコニユー字漢'],
+                ['नमस्ते', 'तेस्मन'],
+            ]
+        );
+    }
 }