[5.3] Add partition collection method

src/Illuminate/Support/Collection.php

@@ -725,6 +725,23 @@ public function forPage($page, $perPage)
         return $this->slice(($page - 1) * $perPage, $perPage);
     }
 
+    /**
+     * Partition the collection into two array using the given callback.
+     *
+     * @param  callable $callback
+     * @return array
+     */
+    public function partition(callable $callback)
+    {
+        $partitions = [new static(), new static()];
+
+        foreach ($this->items as $item) {
+            $partitions[! (int) $callback($item)][] = $item;
+        }
+
+        return $partitions;
+    }
+
     /**
      * Pass the collection to the given callback and return the result.
      *

tests/Support/SupportCollectionTest.php

@@ -1640,6 +1640,27 @@ public function testSplitEmptyCollection()
             })->toArray()
         );
     }
+
+    public function testPartition()
+    {
+        $collection = new Collection(range(1, 10));
+
+        list($firstPartition, $secondPartition) = $collection->partition(function ($i) {
+            return $i <= 5;
+        });
+
+        $this->assertEquals([1, 2, 3, 4, 5], $firstPartition->toArray());
+        $this->assertEquals([6, 7, 8, 9, 10], $secondPartition->toArray());
+    }
+
+    public function testPartitionEmptyCollection()
+    {
+        $collection = new Collection();
+
+        $this->assertCount(2, $collection->partition(function () {
+            return true;
+        }));
+    }
 }
 
 class TestAccessorEloquentTestStub