feat: add eachValue

Author: Fureev Eugene

CHANGELOG.md

@@ -9,6 +9,7 @@ The format is based on [Keep a Changelog][keepachangelog] and this project adher
 ### Added
 
 - Add global method `mapValue` Returns an array containing the results of applying func to the items of the $collection
+- Add global method `eachValue` Apply a $fn to all the items of the $collection
 
 ## v4.14.0
 

src/Global/base.php

@@ -30,6 +30,15 @@ function mapValue(callable $fn, iterable $collection, mixed ...$args): array
     }
 }
 
+if (!function_exists('eachValue')) {
+    function eachValue(callable $fn, iterable $collection, mixed ...$args): void
+    {
+        foreach ($collection as $key => $value) {
+            $fn($value, $key, ...$args);
+        }
+    }
+}
+
 if (!function_exists('when')) {
     /**
      * Returns a value when a condition is truthy.

tests/Global/EachValueTest.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Php\Support\Tests\Global;
+
+use PHPUnit\Framework\TestCase;
+
+final class EachValueTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function eachValue(): void
+    {
+        $result = [];
+        $fnColl = static function (string $value) use (&$result) {
+            $result[] = $value;
+        };
+        $expect = ['test', 'app'];
+        eachValue($fnColl, $expect);
+
+        self::assertEquals($expect, $result);
+    }
+}