Feat: Add Docs for Array Partition (#10227)

* Feat: Add Docs for Array Partition

* Final updates

* PR comments were resolved

---------

Co-authored-by: Pandi Selvam <[email protected]>

Author: pandiselvamm

helpers.md

@@ -60,6 +60,7 @@ Laravel includes a variety of global "helper" PHP functions. Many of these funct
 [Arr::mapSpread](#method-array-map-spread)
 [Arr::mapWithKeys](#method-array-map-with-keys)
 [Arr::only](#method-array-only)
+[Arr::partition](#method-array-partition)
 [Arr::pluck](#method-array-pluck)
 [Arr::prepend](#method-array-prepend)
 [Arr::prependKeysWith](#method-array-prependkeyswith)
@@ -681,6 +682,31 @@ $slice = Arr::only($array, ['name', 'price']);
 // ['name' => 'Desk', 'price' => 100]
 ```
 
+<a name="method-array-partition"></a>
+#### `Arr::partition()` {.collection-method}
+
+The `Arr::partition` method may be combined with PHP array destructuring to separate elements that pass a given truth test from those that do not:
+
+```php
+<?php
+
+use Illuminate\Support\Arr;
+
+$numbers = [1, 2, 3, 4, 5, 6];
+
+[$underThree, $equalOrAboveThree] = Arr::partition($numbers, function (int $i) {
+    return $i < 3;
+});
+
+dump($underThree);
+
+// [1, 2]
+
+dump($equalOrAboveThree);
+
+// [3, 4, 5, 6]
+```
+
 <a name="method-array-pluck"></a>
 #### `Arr::pluck()` {.collection-method}