Add array_find method

Author: joshuaruesweg

src/Php84/Php84.php

@@ -63,4 +63,15 @@ public static function mb_lcfirst(string $string, ?string $encoding = null): str
 
         return $firstChar . mb_substr($string, 1, null, $encoding);
     }
+
+    public static function array_find(array $array, callable $callback)
+    {
+        foreach ($array as $key => $value) {
+            if ($callback($value, $key)) {
+                return $value;
+            }
+        }
+
+        return null;
+    }
 }

src/Php84/bootstrap.php

@@ -23,3 +23,8 @@ function mb_ucfirst($string, ?string $encoding = null): string { return p\Php84:
 if (!function_exists('mb_lcfirst')) {
     function mb_lcfirst($string, ?string $encoding = null): string { return p\Php84::mb_lcfirst($string, $encoding); }
 }
+
+if (!function_exists('array_find')) {
+    function array_find(array $array, callable $callback) { return p\Php84::array_find($array, $callback); }
+}
+

tests/Php84/Php84Test.php

@@ -30,6 +30,13 @@ public function testMbLcFirst(string $string, string $expected): void {
         $this->assertSame($expected, mb_lcfirst($string));
     }
 
+    /**
+     * @dataProvider arrayFindDataProvider
+     */
+    public function testArrayFind(array $array, callable $callback, $expected): void {
+        $this->assertSame($expected, array_find($array, $callback));
+    }
+
     public static function ucFirstDataProvider(): array {
         return [
             ['', ''],
@@ -68,4 +75,22 @@ public static function lcFirstDataProvider(): array {
             ["ß", "ß"],
         ];
     }
+
+    public static function arrayFindDataProvider(): array {
+        $callable = function ($value): bool {
+            return strlen($value) > 2;
+        };
+
+        $callableKey = function ($value, $key): bool {
+            return is_numeric($key);
+        };
+
+        return [
+            [[], $callable, null],
+            [['a', 'aa', 'aaa', 'aaaa'], $callable, 'aaa'],
+            [['a', 'aa'], $callable, null],
+            [['a' => '1', 'b' => '12', 'c' => '123', 'd' => '1234'], $callable, '123'],
+            [['a' => '1', 'b' => '12', 'c' => '123', 3 => '1234'], $callableKey, '1234'],
+        ];
+    }
 }