downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

mt_getrandmax> <max
[edit] Last updated: Fri, 26 Apr 2013

view this page in

min

(PHP 4, PHP 5)

minFind lowest value

Description

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

If the first and only parameter is an array, min() returns the lowest value in that array. If at least two parameters are provided, min() returns the smallest of these values.

Note:

PHP will evaluate a non-numeric string as 0 if compared to integer, but still return the string if it's seen as the numerically lowest value. If multiple arguments evaluate to 0, min() will return the lowest alphanumerical string value if any strings are given, else a numeric 0 is returned.

Parameters

values

An array containing the values.

value1

Any comparable value.

value2

Any comparable value.

...

Any comparable value.

Return Values

min() returns the numerically lowest of the parameter values.

Examples

Example #1 Example uses of min()

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

echo min(0'hello');     // 0
echo min('hello'0);     // hello
echo min('hello', -1);    // -1

// With multiple arrays, min compares from left to right
// so in our example: 2 == 2, but 4 < 5
$val min(array(248), array(251)); // array(2, 4, 8)

// If both an array and non-array are given, the array
// is never returned as it's considered the largest
$val min('string', array(257), 42);   // string
?>

See Also

  • max() - Find highest value
  • count() - Count all elements in an array, or something in an object



mt_getrandmax> <max
[edit] Last updated: Fri, 26 Apr 2013
 
add a note add a note User Contributed Notes min - [25 notes]
up
3
hava82 at gmail dot com
1 year 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
php at keith tyler dot com
2 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
1
piotr_sobolewski at o2 dot nospampleasenono dot pl
5 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
1
Anonymous
7 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
2
johnphayes at gmail dot com
7 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
1
DO
4 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
harmor
5 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
1
Err
3 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
0
matt at borjawebs dot com
2 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
0
steffen at morkland dot com
7 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
0
nonick AT 8027 DOT org
9 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
0
Hayley Watson
3 months ago
Remember that INF is by definition larger than any number.

This is useful for ensuring that an array passed to min() has at least one element (the function doesn't like empty arrays), and for keeping running minima (it provides a starting value that is guaranteed to be replaced by the first value in the sequence).

PHP_INT_MAX works if the numbers are all less than PHP_INT_MAX, but most doubles aren't.
up
0
dave at dtracorp dot com
6 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;
}
up
-1
mlester at ndsuk dot com
4 years ago
I have found a very useful trick to help get round the problem of setting a variable to max int when finding a min i.e.

<?php
$val
= 10;
$min = 100000// This is unpleasant and I couldn't find a equivalent to the C++ MAXINT
if ($val < $min)
{
 
$min = $val;
}
?>

try this ...

<?php
$dataSet
= Array(7, 8, 9, -1, -100, 0, 1, 2, 3, 5, 6);
$min = true;
$max = true;
           
foreach (
$dataSet as $data )
{
  echo(
"data = $data");
 
$min = min($data, $min);
 
$max = max($data, $max);
}
           
echo(
"min = $min");
echo(
"max = $max");
?>

$max can be set to anything e.g. "infinity", but the same trick doesn't work with min, however true does work (false doesn't). Not sure why though.

The above code even works with a data set like this...
<?php $dataSet = Array("0.5", 1, 2, "3", "-1", "5"); ?>

but min doesn't like null or negative float e.g. "-1.2" and "" can give some odd results too.
up
-1
johngreenbury at australianescapes dot com dot au
5 years ago
You will get an "Wrong parameter count" error (PHP 4 and possibly 5) if your array looks like the following:

min(115.23,432.11,0.00,45.76)

The 0.00 creates the error. Convert the 0.00 to a high number such as 10000000000.00 or remove it from the array before running the min() function.
up
-1
7 years ago
Here is my slightly modified version of the bugfree min-version. Now the max() function is no longer used in the modification and overall it's fasten up. Would be nice to get some feedback.

<?php
function min_mod () {
 
$args = func_get_args();
 
  if (!
count($args)) return false;
  else {
   
$min = false;
    foreach (
$args AS $value) {
     
$curval = floatval($value);
      if (
$curval < $min || $min === false) $min = $curval;
    }
  }
 
  return
$min;   
}
?>
up
-1
alx5000 at walla dot com
8 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
-1
kieran at mgpenguin dot net
9 years ago
Further modifications to the minnum function above.. This is for a project where I had to grab an entire column out of a database consisting of values that might be string, might be string representations of numbers (floating point or integer) or might be NULL, and find the minimum NUMERIC value:

function minnum($numarray){
    //dont use min(), it contains a bug!
    $min=0;
    if ( ! is_array($numarray) ) $numarray = func_get_args();
    if(is_array($numarray)==true){
        $min=max($numarray);
        for($z=0;$z<count($numarray);$z++){
            $curval=floatval($numarray[$z]);
            if(($curval != 0) && ($curval < $min)){
                $min=$curval;
            }
        }
    }
    return $min;
}

Gets the floating point value of each entry and uses this to check whether it's actually a number before checking whether it's the minimum or not. Also contains modifications noted above to use it as a drop in replacement for min - ie multiple values passed.
up
-1
calin at php9 dot com
9 years ago
if you have an array like this

$arSrc[0]=14;
$arSrc[1]=16;
$arSrc[2]=13;
$arSrc[3]=17;

then in order to get the min element and its position in the array you can do:

$iMinValue = min($arSrc);
$arFlip = array_flip($arSrc);
$iMinPosition = $arFlip[$iMinValue];

echo
 '<br />min_value=',
 $iMinValue,
 '<br />min_position=',
 $iMinPosition
;

this example works for also for an associative array; of course with numeric values
up
-1
kevin at pricetrak dot com
11 years ago
The 'undefined' behaviour can bit you badly. I would expect min(undefined, -1000) to return -1000. Not so.
up
-2
andrew dot j dot dodson at gmail
4 years ago
min/max works with yyyy-mm-dd dates, e.g.

<?php

$a
= array(   '2008-10-01',    '2008-12-01'  );

print
min($a); //  '2008-10-01'
print max($a); //  '2008-12-01'

?>

Which is a unexpected since at the top of this page it says.
"PHP will evaluate a non-numeric string as 0"

And if we cast it as an int then we get the year

<?php
print (int)"2008-01-12"; // 2008
?>
up
-2
ksours at internetbrands dot com
4 years ago
PHP_INT_MAX is the MAXINT equivalent
up
-2
browne at bee why you dot ee dee you
9 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
-2
Merome at wanadoo dot fr
9 years ago
Caution : it seems that min() can return a string :

min(";",50)=";" (I expected zero)
up
-2
Anonymous
10 years ago
Re: above example - for a proper drop in replacement for the above, insert

if ( ! is_array($numarray) )
   $numarray = func_get_args();

after
   $min=0;

(For PHP3, check
if (intval(PHP_VERSION) >= 4 && ! is_array($numarray))
   $numarray = func_get_args();
)

 
show source | credits | stats | sitemap | contact | advertising | mirror sites