Update randomElements to return random number of elements when no count is provided

calebdw · calebdw · commit 5c6faa4185dc · 2023-06-09T10:33:06.000-05:00
diff --git a/docs/formatters/numbers-and-strings.md b/docs/formatters/numbers-and-strings.md
@@ -92,7 +92,7 @@ echo $faker->randomLetter();
 
 ## `randomElements`
 
-Returns `$count` amount of random element from the given array, traversable, or enum. By default, the `$count` parameter is set to 1.
+Returns `$count` amount of random element from the given array, traversable, or enum. By default, the `$count` parameter is set to 1, when `null` a random number of elements is returned.
 
 ```php
 echo $faker->randomElements(['a', 'b', 'c', 'd', 'e']);
@@ -116,6 +116,10 @@ echo $faker->randomElements(Bar::class);
 
 // ['c']
 
+echo $faker->randomElements(Bar::class, null);
+
+// ['c', 'a']
+
 echo $faker->randomElements(['a', 'b', 'c', 'd', 'e'], 3);
 
 // ['a', 'd', 'e']
