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

search for in the

min> <log
Last updated: Fri, 05 Sep 2008

view this page in

max

(PHP 4, PHP 5)

maxFind highest value

Description

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

If the first and only parameter is an array, max() returns the highest value in that array. If at least two parameters are provided, max() returns the biggest 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 highest value. If multiple arguments evaluate to 0, max() will return a numeric 0 if given, else the alphabetical highest string value will be returned.

Parameters

values

An array containing the values.

Return Values

max() returns the numerically highest of the parameter values.

Examples

Example #1 Example uses of max()

<?php
echo max(13567);  // 7
echo max(array(245)); // 5

echo max(0'hello');     // 0
echo max('hello'0);     // hello
echo max(-1'hello');    // hello

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

// If both an array and non-array are given, the array
// is always returned as it's seen as the largest
$val max('string', array(257), 42);   // array(2, 5, 7)
?>

See Also



min> <log
Last updated: Fri, 05 Sep 2008
 
add a note add a note User Contributed Notes
max
henk at tobbe dot net dot au
16-Apr-2008 10:05
In a publication by WROX I noted a variant of the earlier "bound" function:

A parameter had to be between 1 and 3...

$par=round((min(max($x,1),3));
stuff at necr0manzer dot de
03-Mar-2008 09:11
mick at wireframe dot com's solution to finding the key for the highest value didn't work for me, so I wrote one myself:

<?php
function max_key($array) {
    foreach (
$array as $key => $val) {
        if (
$val == max($array)) return $key;
    }
}

$array = array(1, 2, 5, 7, 4);
echo
max($array); // 7
echo max_key($array); // 3
?>

of course this also works with associative arrays, but it will only return a single result!
harmor
21-Feb-2008 07:56
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
mick at wireframe dot com
31-Oct-2007 01:51
There are a couple of things you can do for cleaner code if you want the keys returned from the array. I am not sure how they each impact performance, but the visual readability is more beneficial for me -- your mileage may vary.

In the first example keys and max value is returned:

<?php
// First, let's pretend we have an array like this:
$Some_Array = array(
 
'john' => 40,
 
'susan' => 40,
 
'jane' => 24,
 
'michael' => 19,
 
'jimmy' => 38
);

function
max_extract($My_Array) {

 
$Max_Value = max($My_Array);
  return
array_fill_keys(array_keys($My_Array, $Max_Value), $Max_Value);

}
// ! max_extract()
?>

Or, if you are only interested in the keys and don't care what the max is:

<?php
function max_extract($My_Array) {

  return
array_keys($My_Array, max($My_Array));
 
// You can also array_flip() this is you want them as keys
  // or if some other reason makes this relevant/needed.

} // ! max_extract()
?>

There are many possible variations when using the search parameter of array_keys() along with other array functions.
sta
07-Sep-2007 07:05
Or to take multiple maximum values into consideration:

function doublemax($mylist){
    $maxvalue=max($mylist);
    $max_keys = array();
   
        while(list($key,$value)=each($mylist)){
        if($value==$maxvalue)
        array_push($max_keys,$key);
    }
    return $max_keys;
}
joan dot codina at upf dot edu
14-Jul-2007 08:11
This is highly ineficient, but can be a bit better

<?
function doublemax($mylist){
  $maxvalue=max($mylist);
  while(list($key,$value)=each($mylist)){
     if($value==$maxvalue)
    return array("key"=>$key,"value"=>$value);
  }
}
?>
michaelangel0 at mail.com
05-Jul-2007 01:00
Matlab users and others may feel lonely without the double argument output from min and max functions.

To have the INDEX of the highest value in an array, as well as the value itself, use the following, or a derivative:

<?
function doublemax($mylist){
  $maxvalue=max($mylist);
  while(list($key,$value)=each($mylist)){
    if($value==$maxvalue)$maxindex=$key;
  }
  return array("m"=>$maxvalue,"i"=>$maxindex);
}
?>
jeremi23 at gmail dot com
14-Jun-2007 01:09
max on a an array with key/values

<?
$tmp = array(1 => 5, 2=> 3);
echo max($tmp);
?>

this return 5, so the max is done on the values.
johnmott59 at hotmail dot com
17-May-2007 10:35
To find the maximum value from a set of 1-dimensional arrays, do this:

$d1 = array(450,420,440,430,421);
$d2 = array(460,410,410,430,413,375,256,411,656);
$d3 = array(430,440,470,435,434,255,198);

$t = max(max($d1),max($d2),max($d3));
// $t is 656

The inner max() functions operate on the arrays, the outer max compares the numeric results of the inner ones.
johnphayes at gmail dot com
02-May-2006 07:27
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
tim at (NOSPAM) dot crazynot2 dot com
08-Nov-2005 11:56
In response to the previous two posters (zher0 at netcarrier dot com & walkingmantis):

I was trying to do exactly what zher0 suggested; calculate the max value of a multi-dimensional array with variably sized 'sub-arrays'.  Here is a simple little function I came up with to do just that:

<?php
function multimax( $array ) {
   
// use foreach to iterate over our input array.
   
foreach( $array as $value ) {
       
       
// check if $value is an array...
       
if( is_array($value) ) {
           
           
// ... $value is an array so recursively pass it into multimax() to
            // determine it's highest value.
           
$subvalue = multimax($value);
           
           
// if the returned $subvalue is greater than our current highest value,
            // set it as our $return value.
           
if( $subvalue > $return ) {
               
$return = $subvalue;
            }
       
        } elseif(
$value > $return) {
           
// ... $value is not an array so set the return variable if it's greater
            // than our highest value so far.
           
$return = $value;
        }
    }
   
   
// return (what should be) the highest value from any dimension.
   
return $return;
}
?>

Please note that I have only performed very limited testing on this code -- be sure to check it thoroughly if you implement it somewhere!
nonick AT 8027 DOT org
17-Dec-2003 05:50
If you are working with numbers, then you can use:

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

which is somewhat faster (roughly 16%) than

    $a = max($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.
mikhail_kovalev at mail dot ru
14-May-2003 02:32
Note that in version 4.0.3 (the only version I tested):

max (0, 0); // returns 0.
max (0, false); // returns 0.
max (false, 0); // returns false.
max (false, false); // returns false.

As a solution use this:

(int) max (false, 0); // returns 0.
(int) max (false, false); // returns 0.

min> <log
Last updated: Fri, 05 Sep 2008
 
 
show source | credits | stats | sitemap | contact | advertising | mirror sites