Add array_find_key method

Author: joshuaruesweg

src/Php84/Php84.php

@@ -74,4 +74,15 @@ public static function array_find(array $array, callable $callback)
 
         return null;
     }
+
+    public static function array_find_key(array $array, callable $callback)
+    {
+        foreach ($array as $key => $value) {
+            if ($callback($value, $key)) {
+                return $key;
+            }
+        }
+
+        return null;
+    }
 }

src/Php84/bootstrap.php

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

tests/Php84/Php84Test.php

@@ -37,6 +37,13 @@ public function testArrayFind(array $array, callable $callback, $expected): void
         $this->assertSame($expected, array_find($array, $callback));
     }
 
+    /**
+     * @dataProvider arrayFindKeyDataProvider
+     */
+    public function testArrayFindKey(array $array, callable $callback, $expected): void {
+        $this->assertSame($expected, array_find_key($array, $callback));
+    }
+
     public static function ucFirstDataProvider(): array {
         return [
             ['', ''],
@@ -93,4 +100,22 @@ public static function arrayFindDataProvider(): array {
             [['a' => '1', 'b' => '12', 'c' => '123', 3 => '1234'], $callableKey, '1234'],
         ];
     }
+
+    public static function arrayFindKeyDataProvider(): 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, 2],
+            [['a', 'aa'], $callable, null],
+            [['a' => '1', 'b' => '12', 'c' => '123', 'd' => '1234'], $callable, 'c'],
+            [['a' => '1', 'b' => '12', 'c' => '123', 3 => '1234'], $callableKey, 3],
+        ];
+    }
 }