min

(PHP 4, PHP 5, PHP 7)

min最小値を返す

説明

mixed min ( array $values )
mixed min ( mixed $value1 , mixed $value2 [, mixed $... ] )

パラメータとして配列をひとつだけ渡した場合は、 min() は配列の中で最も小さい数値を返します。 ふたつ以上のパラメータを指定した場合は、min() はそれらの中で最も小さいものを返します。

注意:

異なる型の値を比較する際には、 標準の比較ルールに従います。 たとえば、数値形式でない stringinteger と比較するときには、数値 0 と評価します。 しかし、数値形式でない string どうしを比較するときには、アルファベット順で評価します。 返される値は、何も変換をしていない、元の型の値となります。

警告

異なる型の値を引数として渡す際には注意しましょう。 min() が予期せぬ結果を返す可能性があるからです。

パラメータ

values

値を含む配列。

value1

Any 比較可能な値。

value2

Any 比較句可能な値。

...

Any 比較可能な値。

返り値

min() は、パラメータとして渡した値の中で、標準の比較ルールに従って最小になるものを返します。 異なる型で同じ値と評価される複数の値 (0'abc' など) があった場合は、関数に最初に渡されたほうを返します。

空の配列を渡した場合は FALSE を返し、 E_WARNING が発生します。

例1 min() の例

<?php
echo min(23167);  // 1
echo min(array(245)); // 2

// 'hello' を int と比較するときは、0 と評価します。ふたつの値が
// 等しくなるので、パラメータを渡した順によって結果が決まります
echo min(0'hello');     // 0
echo min('hello'0);     // hello

// -1 と 0 の比較なので、-1 のほうが小さくなります
echo min('hello', -1);    // -1

// 長さが異なる複数の配列を渡すと、いちばん短い配列を返します
$val min(array(222), array(1111)); // array(2, 2, 2)

// 同じ長さの複数の配列を渡すと、max はその要素を左から
// 辞書順に比較します。この例では 2 == 2 ですが 4 < 5 となります
$val min(array(248), array(251)); // array(2, 4, 8)

// 配列と配列でない値が渡された場合、常に
// 配列が最大と判定されます。
$val min('string', array(257), 42);   // string

// 一方の値が NULL や boolean の場合、それを他の値と比較するときには、
// もう一方の値の型が何であるかにかかわらず、
// FALSE < TRUE / NULL == FALSE というルールを使います。
// 以下の例では、-10 と 10 はどちらも TRUE と評価されます。
$val min(-10FALSE10); // FALSE
$val min(-10NULL10);  // NULL

// 一方 0 は FALSE と評価されるので、TRUE よりは小さいとみなされます。
$val min(0TRUE); // 0
?>

参考

  • max() - 最大値を返す
  • count() - 変数に含まれるすべての要素、 あるいはオブジェクトに含まれる何かの数を数える

add a note add a note

User Contributed Notes 17 notes

up
7
volch5 at gmail dot com
3 years ago
min() (and max()) on DateTime objects compares them like dates (with timezone info) and returns DateTime object.
<?php
$dt1
= new DateTime('2014-05-07 18:53', new DateTimeZone('Europe/Kiev'));
$dt2 = new DateTime('2014-05-07 16:53', new DateTimeZone('UTC'));
echo
max($dt1,$dt2)->format(DateTime::RFC3339) . PHP_EOL; // 2014-05-07T16:53:00+00:00
echo min($dt1,$dt2)->format(DateTime::RFC3339) . PHP_EOL; // 2014-05-07T18:53:00+03:00
?>

It works at least 5.3.3-7+squeeze17
up
6
Teelevision
4 years ago
A function that returns the lowest integer that is not 0.
<?php
/* like min(), but casts to int and ignores 0 */
function min_not_null(Array $values) {
    return
min(array_diff(array_map('intval', $values), array(0)));
}
?>
up
2
harmor
9 years ago
A way to bound a integer between two values is:

function bound($x, $min, $max)
{
     return min(max($x, $min), $max);
}

which is the same as:

$tmp = $x;
if($tmp < $min)
{
    $tmp = $min;
}
if($tmp > $max)
{
     $tmp = $max;
}
$y = $tmp;

So if you wanted to bound an integer between 1 and 12 for example:

Input:
$x = 0;
echo bound(0, 1, 12).'<br />';
$x = 1;
echo bound($x, 1, 12).'<br />';
$x = 6;
echo bound($x, 1, 12).'<br />';
$x = 12;
echo bound($x, 1, 12).'<br />';
$x = 13;
echo bound($x, 1, 12).'<br />';

Output:
1
1
6
12
12
up
0
8ilO
7 months ago
A min_by function:
<?php
function min_by(Array $arr, Callable $func){
   
$mapped = array_map($func, $arr);
    return
$arr[array_search(min($mapped), $mapped)];
}
$a = ["albatross""dog""horse"];
echo
min_by($a, "strlen"); // dog
?>
up
0
piotr_sobolewski at o2 dot nospampleasenono dot pl
10 years ago
Be very careful when your array contains both strings and numbers. This code works strange (even though explainable) way:
var_dump(max('25.1.1', '222', '99'));
var_dump(max('2.1.1', '222', '99'));
up
0
steffen at morkland dot com
11 years ago
> NEVER EVER use this function with boolean variables !!!
> Or you'll get something like this: min(true, 1, -2) == true;

> Just because of:
> min(true, 1, -2) == min(min(true,1), -2) == min(true, -2) == true;

It is possible to use it with booleans, there is is just one thing, which you need to keep in mind, when evaluating using the non strict comparison (==) anyting that is not bool false, 0 or NULL is consideret true eg.:
(5 == true) = true;
(0 == true) = false;
true is also actually anything else then 0, false and null. However when true is converted to a string or interger true == 1, therefore when sorting true = 1. But if true is the maximum number bool true is returned. so to be sure, if you only want to match if true is the max number remember to use the strict comparison operater ===
up
-1
Anonymous
11 years ago
NEVER EVER use this function with boolean variables !!!
Or you'll get something like this: min(true, 1, -2) == true;

Just because of:
min(true, 1, -2) == min(min(true,1), -2) == min(true, -2) == true;

You are warned !
up
-1
johnphayes at gmail dot com
11 years ago
Regarding boolean parameters in min() and max():

(a) If any of your parameters is boolean, max and min will cast the rest of them to boolean to do the comparison.
(b) true > false
(c) However, max and min will return the actual parameter value that wins the comparison (not the cast).

Here's some test cases to illustrate:

1.  max(true,100)=true
2.  max(true,0)=true
3.  max(100,true)=100
4.  max(false,100)=100
5.  max(100,false)=100
6.  min(true,100)=true
7.  min(true,0)=0
8.  min(100,true)=100
9.  min(false,100)=false
10. min(100,false)=false
11. min(true,false)=false
12. max(true,false)=true
up
-2
DO
9 years ago
I've modified the bugfree min-version to ignore NULL values (else it returns 0).

<?php
function min_mod () {
 
$args = func_get_args();

  if (!
count($args[0])) return false;
  else {
   
$min = false;
    foreach (
$args[0] AS $value) {
      if (
is_numeric($value)) {
       
$curval = floatval($value);
        if (
$curval < $min || $min === false) $min = $curval;
      }
    }
  }

  return
$min;  
}
?>
up
-1
nonick AT 8027 DOT org
13 years ago
I tested this with max(), but I suppose it applies to min() too: If you are working with numbers, then you can use:

    $a = ($b < $c) ? $b : $c;

which is somewhat faster (roughly 16%) than

    $a = min($b, $c);

I tested this on several loops using integers and floats, over 1 million iterations.

I'm running PHP 4.3.1 as a module for Apache 1.3.27.
up
-2
hava82 at gmail dot com
6 years ago
Here is function can find min by array key

<?php
function min_by_key($arr, $key){
   
$min = array();
    foreach (
$arr as $val) {
        if (!isset(
$val[$key]) and is_array($val)) {
           
$min2 = min_by_key($val, $key);
           
$min[$min2] = 1;
        } elseif (!isset(
$val[$key]) and !is_array($val)) {
            return
false;
        } elseif (isset(
$val[$key])) {
           
$min[$val[$key]] = 1;
        }
    }
    return
min( array_keys($min) );
}
?>
up
-2
alx5000 at walla dot com
12 years ago
If you want min to return zero (0) when comparing to a string, try this:

<?php
min
(3,4,";");  // ";"
min(0,min(3,4,";")) // 0
?>
up
-3
php at keith tyler dot com
7 years ago
If NAN is the first argument to min(), the second argument will always be returned.

If NAN is the second argument, NAN will always be returned.

The relationship is the same but inverted for max().

<?php
// \n's skipped for brevity
print max(0,NAN);
print
max(NAN,0);
print
min(0,NAN);
print
min(NAN,0);
?>

Returns:
0
NAN
NAN
0
up
-4
matt at borjawebs dot com
7 years ago
A condensed version (and possible application) of returning an array of array keys containing the same minimum value:

<?php
// data
$min_keys = array();
$player_score_totals = array(
'player1' => 300,
'player2' => 301,
'player3' => 302,
'player4' => 301,
...
);

// search for array keys with min() value
foreach($player_score_totals as $playerid => $score)
    if(
$score == min($player_score_totals)) array_push($min_keys, $playerid);

print_r($min_keys);
?>
up
-8
Err
8 years ago
When using a variable with an array that has a list of numbers, put just the variable in min(). Don't use integer index's. Seems pretty straight forward now, but I wasn't used to just putting down the variable for an array in functions.

<?php
  $list
= array(9,5,4,6,2,7);
  echo
min($list); // display 2
?>
up
-9
browne at bee why you dot ee dee you
13 years ago
min() can be used to cap values at a specific value. For instance, if you're grading papers and someone has some extra credit, but  that shouldn't make it to the final score:

$pts_possible = 50;
$score = 55;

// Percent will equal 1 if $score/$pts_possible is greater than 1
$percent = min($score/$pts_possible,1);
up
-7
dave at dtracorp dot com
11 years ago
empty strings '' will also return false or 0, so if you have something like

$test = array('', 1, 5, 8, 44, 22);

'' will be returned as the lowest value

if you only want to get the lowest number, you'll have to resort to the old fashioned loop

// default minimum value
$minVal = 100;
foreach ($test as $value) {
if (is_numeric($value) && $value < $minVal) {
$minVal = $value;
}
To Top