setup each function

Author: transistive

src/Types/AbstractCypherSequence.php

@@ -212,4 +212,20 @@ public function join(?string $glue = null): string
         /** @psalm-suppress MixedArgumentTypeCoercion */
         return implode($glue ?? '', $this->sequence);
     }
+
+    /**
+     * Iterates over the sequence and applies the callable.
+     *
+     * @param callable(TValue, TKey):void $callable
+     *
+     * @return static<TValue, TKey>
+     */
+    public function each(callable $callable): self
+    {
+        foreach ($this->sequence as $key => $value) {
+            $callable($value, $key);
+        }
+
+        return $this;
+    }
 }

tests/Unit/CypherListTest.php

@@ -352,6 +352,15 @@ public function testSortedCustom(): void
         self::assertEquals(new CypherList(['A', 'B', 'C']), $this->list);
     }
 
+    public function testEach(): void
+    {
+        $cntr = -1;
+        /** @psalm-suppress UnusedClosureParam */
+        $this->list->each(static function (string $x, int $key) use (&$cntr) { $cntr = $key; });
+
+        self::assertEquals($this->list->count() - 1, $cntr);
+    }
+
     public function testMapTypings(): void
     {
         $map = CypherList::fromIterable(['a', 'b', 'c'])