lodash-php · dielshin · Mar 29, 2023 · pierredup · Dec 12, 2023 · dielshin
diff --git a/src/Math/minBy.php b/src/Math/minBy.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the SolidWorx Lodash-PHP project.
+ *
+ * @author     Pierre du Plessis <open-source@solidworx.co>
+ * @copyright  Copyright (c) 2018
+ */
+
+namespace _;
+
+use function _\internal\baseIteratee;
+
+/**
+ * This method is like `min` except that it accepts `iteratee` which is
+ * invoked for each element in `array` to generate the criterion by which
+ * the value is ranked. The iteratee is invoked with one argument: (value).
+ *
+ * @category Math
+ *
+ * @param array           $array    The array to iterate over.
+ * @param callable|string $iteratee The iteratee invoked per element.
+ *
+ * @return mixed Returns the minimum value.
+ * @example
+ * <code>
+ * $objects = [['n' => 1], ['n' => 2]];
+ *
+ * minBy($objects, function($o) { return $o['n']; });
+ * // => ['n' => 1]
+ *
+ * // The `property` iteratee shorthand.
+ * minBy($objects, 'n');
+ * // => ['n' => 1]
+ * </code>
+ */
+function minBy(?array $array, $iteratee)
+{
+    $iteratee = baseIteratee($iteratee);
+    $result = null;
+    $computed = null;
+
+    foreach ($array as $key => $value) {
+        $current = $iteratee($value);
+
+        if (null !== $current && (null === $computed ? ($current === $current) : $current < $computed)) {
+            $computed = $current;
+            $result = $value;
+        }
+    }
+
+    return $result;
+}