wip chunk

README.md

@@ -121,6 +121,7 @@ All of these methods manipulate the array, but not all of them return an instanc
 `->shift()` removes the first element from the array and returns it.
 
 - `->changeKeyCase()`
+- `->chunk(int[, array])`
 - `->combine(array|Chain, array|Chain)`
 - `->count()`
 - `->diff(array|Chain)`

src/Chain.php

@@ -3,6 +3,7 @@
 namespace Cocur\Chain;
 
 use Cocur\Chain\Link\ChangeKeyCase;
+use Cocur\Chain\Link\Chunk;
 use Cocur\Chain\Link\Combine;
 use Cocur\Chain\Link\Count;
 use Cocur\Chain\Link\CountValues;
@@ -54,6 +55,7 @@
 class Chain extends AbstractChain implements Countable
 {
     use ChangeKeyCase;
+    use Chunk;
     use Combine;
     use Count;
     use CountValues;

src/Link/Chunk.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Cocur\Chain\Link;
+
+/**
+ * Chunk.
+ *
+ * @author    Nicolas Reynis
+ */
+trait Chunk
+{
+    /**
+     * @param int   $size
+     * @param array $options options, including:
+     *                       bool `preserveKeys` to prevent reindexing, default to false
+     *                       bool `decorate` to generate chains instead of arrays, default tu true
+     *
+     * @return self
+     */
+    public function chunk(int $size, array $options = []): self
+    {
+        if (!empty($options['preserveKeys'])) {
+            $this->array = array_chunk($this->array, $size, $options['preserveKeys']);
+        } else {
+            $this->array = array_chunk($this->array, $size);
+        }
+
+        if (empty($options['decorate']) || true === $options['decorate']) {
+            foreach ($this->array as $index => $chunk) {
+                $this->array[$index] = new static($chunk);
+            }
+        }
+
+        return $this;
+    }
+}

tests/ChainTest.php

@@ -77,6 +77,7 @@ public function chainHasTraits(): void
         $c = new Chain();
 
         $this->assertTrue(method_exists($c, 'changeKeyCase'));
+        $this->assertTrue(method_exists($c, 'chunk'));
         $this->assertTrue(method_exists($c, 'combine'));
         $this->assertTrue(method_exists($c, 'count'));
         $this->assertTrue(method_exists($c, 'countValues'));

tests/Link/ChunkTest.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Cocur\Chain\Link;
+
+/**
+ * EveryTest.
+ *
+ * @author    Nicolas Reynis
+ * @group     unit
+ */
+class ChunkTest extends \PHPUnit\Framework\TestCase
+{
+    /**
+     * @test
+     * @covers \Cocur\Chain\Link\Chunk::chunk()
+     */
+    public function everyReturnTrueWhenConditionPass(): void
+    {
+        /** @var Every $mock */
+        $mock        = $this->getMockForTrait(Chunk::class);
+        $mock->array = [1, 2, 3, 4];
+        $mock->chunk(2);
+
+        $this->assertEquals([1, 2], $mock->array[0]->array);
+        $this->assertEquals([3, 4], $mock->array[1]->array);
+    }
+}