feat(strings): add new method newLine

Author: Awilum

src/Strings.php

@@ -2768,7 +2768,21 @@ public function dd(?callable $callback = null): void
 
         exit(1);
     }
-    
+
+    /**
+     * Append a new line to the string.
+     *
+     * @param  int  $count Count of new lines. Default is 1.
+     * 
+     * @return self Returns instance of the Strings class.
+     *
+     * @access public
+     */
+    public function newLine(int $count = 1): self
+    {
+        return $this->append(str_repeat(PHP_EOL, $count));
+    }
+
     /**
      * Returns a new ArrayIterator, thus implementing the IteratorAggregate
      * interface. The ArrayIterator's constructor is passed an array of chars

tests/StringsTest.php

@@ -515,6 +515,11 @@
     $this->assertEquals('#Stranger Things#', Strings::create('Stranger Things')->wrap('#')->toString());
 });
 
+test('test newLine() method', function(): void {
+    $this->assertEquals('Foo' . PHP_EOL, Strings::create('Foo')->newLine()->toString());
+    $this->assertEquals('Foo' . PHP_EOL . PHP_EOL, Strings::create('Foo')->newLine(2)->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());