max

(PHP 4, PHP 5, PHP 7, PHP 8)

max β€” Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅Ρ‚ наибольшСС Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

ОписаниС

function max(mixed $value, mixed ...$values): mixed

ΠΠ»ΡŒΡ‚Π΅Ρ€Π½Π°Ρ‚ΠΈΠ²Π½Π°Ρ сигнатура (Π½Π΅ поддСрТиваСтся с ΠΈΠΌΠ΅Π½ΠΎΠ²Π°Π½Π½Ρ‹ΠΌΠΈ Π°Ρ€Π³ΡƒΠΌΠ΅Π½Ρ‚Π°ΠΌΠΈ):

function max(array $value_array): mixed

Ѐункция max() Π²Π΅Ρ€Π½Ρ‘Ρ‚ наибольшСС Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ массива, Ссли ΠΏΠ΅Ρ€Π²Ρ‹ΠΉ ΠΈ СдинствСнный ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ β€” массив. Ѐункция max() Π²Π΅Ρ€Π½Ρ‘Ρ‚ наибольший ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€, Ссли ΠΏΠ΅Ρ€Π΅Π΄Π°Π»ΠΈ хотя Π±Ρ‹ Π΄Π²Π° ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Π°.

Π—Π°ΠΌΠ΅Ρ‡Π°Π½ΠΈΠ΅:

Ѐункция сравниваСт Ρ€Π°Π·Π½ΠΎΡ‚ΠΈΠΏΠ½Ρ‹Π΅ значСния ΠΏΠΎ стандартным ΠΏΡ€Π°Π²ΠΈΠ»Π°ΠΌΠΈ сравнСния. ΠΠ΅Ρ‡ΠΈΡΠ»ΠΎΠ²ΡƒΡŽ строку (string), Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, функция сравнит с Ρ†Π΅Π»Ρ‹ΠΌ числом (int) Ρ‚Π°ΠΊ, ΠΊΠ°ΠΊ Ссли Π±Ρ‹ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ строки Ρ€Π°Π²Π½ΡΠ»ΠΎΡΡŒ 0, Π½ΠΎ нСчисловыС строки (string) ΠΌΠ΅ΠΆΠ΄Ρƒ собой ΡΡ€Π°Π²Π½ΠΈΠ²Π°ΡŽΡ‚ΡΡ Π² Π°Π»Ρ„Π°Π²ΠΈΡ‚Π½ΠΎ-Ρ†ΠΈΡ„Ρ€ΠΎΠ²ΠΎΠΌ порядкС. Π—Π½Π°Ρ‡Π΅Π½ΠΈΠ΅, ΠΊΠΎΡ‚ΠΎΡ€ΠΎΠ΅ Π²Π΅Ρ€Π½Ρ‘Ρ‚ функция, сохранит исходный Ρ‚ΠΈΠΏ Π±Π΅Π· прСобразования.

ΠŸΡ€Π΅Π΄ΠΎΡΡ‚Π΅Ρ€Π΅ΠΆΠ΅Π½ΠΈΠ΅

ΠŸΡ€ΠΈ ΠΏΠ΅Ρ€Π΅Π΄Π°Ρ‡Π΅ Ρ€Π°Π·Π½ΠΎΡ‚ΠΈΠΏΠ½Ρ‹Ρ… Π°Ρ€Π³ΡƒΠΌΠ΅Π½Ρ‚ΠΎΠ² ΡΠΎΠ±Π»ΡŽΠ΄Π°ΡŽΡ‚ ΠΎΡΡ‚ΠΎΡ€ΠΎΠΆΠ½ΠΎΡΡ‚ΡŒ, ΠΏΠΎΡΠΊΠΎΠ»ΡŒΠΊΡƒ ΠΏΡ€ΠΈ сравнСнии Π·Π½Π°Ρ‡Π΅Π½ΠΈΠΉ Ρ€Π°Π·Π½Ρ‹Ρ… Ρ‚ΠΈΠΏΠΎΠ² функция max() Π²ΠΎΠ·Π²Ρ€Π°Ρ‰ΡˆΠ°Π΅Ρ‚ нСпрСдсказуСмый Ρ€Π΅Π·ΡƒΠ»ΡŒΡ‚Π°Ρ‚.

Бписок ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ΠΎΠ²

value

ΠŸΡ€ΠΎΠΈΠ·Π²ΠΎΠ»ΡŒΠ½ΠΎΠ΅ сравнимоС Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅.

values

Π›ΡŽΠ±Ρ‹Π΅ сравнимыС значСния.

value_array

Массив Π·Π½Π°Ρ‡Π΅Π½ΠΈΠΉ.

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΡ‹Π΅ значСния

Ѐункция max() Π²Π΅Ρ€Π½Ρ‘Ρ‚ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Π°, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ посчитаСт «наибольшим» ΠΏΠΎ стандартным ΠΏΡ€Π°Π²ΠΈΠ»Π°ΠΌ сравнСния. Ѐункция Π²Π΅Ρ€Π½Ρ‘Ρ‚ ΠΏΠ΅Ρ€Π²ΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅, Ссли Ρ€Π°Π·Π½ΠΎΡ‚ΠΈΠΏΠ½Ρ‹Π΅ значСния ΠΎΡ†Π΅Π½ΠΈΠ²Π°ΡŽΡ‚ΡΡ ΠΊΠ°ΠΊ Ρ€Π°Π²Π½Ρ‹Π΅ (Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, 0 ΠΈ Β«abcΒ»).

Ошибки

Ѐункция max() выбрасываСт ΠΈΡΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠ΅ ValueError, Ссли ΠΏΠ΅Ρ€Π΅Π΄Π°Π»ΠΈ пустой массив.

Бписок измСнСний

ВСрсия ОписаниС
8.0.0 Ѐункция max() Ρ‚Π΅ΠΏΠ΅Ρ€ΡŒ выбрасываСт ΠΈΡΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠ΅ ValueError, Ссли Π²ΠΎΠ·Π½ΠΈΠΊΠ»Π° ошибка; Ρ€Π°Π½ΡŒΡˆΠ΅ Π²ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π»ΠΎΡΡŒ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ false ΠΈ Π²Ρ‹Π΄Π°Π²Π°Π»Π°ΡΡŒ ошибка уровня E_WARNING.
8.0.0 ΠŸΠΎΡΠΊΠΎΠ»ΡŒΠΊΡƒ сравнСния строк с числами измСнились, функция max() большС Π½Π΅ Π²ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅Ρ‚ Π΄Ρ€ΡƒΠ³ΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ Π² зависимости ΠΎΡ‚ порядка Π°Ρ€Π³ΡƒΠΌΠ΅Π½Ρ‚ΠΎΠ² для Ρ‚Π°ΠΊΠΈΡ… случаСв.

ΠŸΡ€ΠΈΠΌΠ΅Ρ€Ρ‹

ΠŸΡ€ΠΈΠΌΠ΅Ρ€ #1 ΠŸΡ€ΠΈΠΌΠ΅Ρ€ получСния наибольшСго значСния Ρ„ΡƒΠ½ΠΊΡ†ΠΈΠ΅ΠΉ max()

<?php

echo max(2, 3, 1, 6, 7), PHP_EOL; // 7
echo max(array(2, 4, 5)), PHP_EOL; // 5

// Π—Π΄Π΅ΡΡŒ ΡΡ€Π°Π²Π½ΠΈΠ²Π°ΡŽΡ‚ΡΡ 0 > -1, поэтому 'hello' большС
echo max('hello', -1), PHP_EOL; // hello

// ΠŸΡ€ΠΈ сравнСнии массивов Ρ€Π°Π·Π½ΠΎΠΉ Π΄Π»ΠΈΠ½Ρ‹ функция max Π²Π΅Ρ€Π½Ρ‘Ρ‚ Π±ΠΎΠ»Π΅Π΅ Π΄Π»ΠΈΠ½Π½Ρ‹ΠΉ
$val = max(array(2, 2, 2), array(1, 1, 1, 1)); // array(1, 1, 1, 1)
var_dump($val);

// ΠŸΡ€ΠΈ сравнСнии массивов ΠΎΠ΄ΠΈΠ½Π°ΠΊΠΎΠ²ΠΎΠΉ Π΄Π»ΠΈΠ½Ρ‹ β€” функция max Π±ΡƒΠ΄Π΅Ρ‚ ΡΡ€Π°Π²Π½ΠΈΠ²Π°Ρ‚ΡŒ ΠΈΡ… поэлСмСнтно
// слСва Π½Π°ΠΏΡ€Π°Π²ΠΎ, Π² этом ΠΏΡ€ΠΈΠΌΠ΅Ρ€Π΅ 2 == 2, Π½ΠΎ 4 < 5
$val = max(array(2, 4, 8), array(2, 5, 1)); // array(2, 5, 1)
var_dump($val);

// Если ΠΏΠ΅Ρ€Π΅Π΄Π°Π½ массив ΠΈ Π½Π΅ массив, Π±ΡƒΠ΄Π΅Ρ‚ Π²ΠΎΠ·Π²Ρ€Π°Ρ‰Ρ‘Π½ массив
$val = max('string', array(2, 5, 7), 42); // array(2, 5, 7)
var_dump($val);

// Π—Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ NULL ΠΈΠ»ΠΈ логичСскоС Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅, ΠΊΠΎΡ‚ΠΎΡ€ΠΎΠ΅ ΠΏΠ΅Ρ€Π΅Π΄Π°Π»ΠΈ Π² ΠΊΠ°ΠΊΠΎΠΌ-Π»ΠΈΠ±ΠΎ Π°Ρ€Π³ΡƒΠΌΠ΅Π½Ρ‚Π΅, сравниваСтся с Π΄Ρ€ΡƒΠ³ΠΈΠΌΠΈ
// значСниями ΠΏΠΎ ΠΏΡ€Π°Π²ΠΈΠ»Ρƒ FALSE < TRUE нСзависимо
// ΠΎΡ‚ Ρ‚ΠΈΠΏΠ° Π΄Ρ€ΡƒΠ³ΠΈΡ… Π°Ρ€Π³ΡƒΠΌΠ΅Π½Ρ‚ΠΎΠ².
// Π’ ΡΠ»Π΅Π΄ΡƒΡŽΡ‰Π΅ΠΌ ΠΏΡ€ΠΈΠΌΠ΅Ρ€Π΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ -10 трактуСтся ΠΊΠ°ΠΊ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ TRUE
$val = max(-10, FALSE); // -10
var_dump($val);

// 0 трактуСтся ΠΊΠ°ΠΊ FALSE, Π·Π½Π°Ρ‡ΠΈΡ‚, ΠΎΠ½ «мСньшС» TRUE
$val = max(0, TRUE); // TRUE
var_dump($val);

?>

Π‘ΠΌΠΎΡ‚Ρ€ΠΈΡ‚Π΅ Ρ‚Π°ΠΊΠΆΠ΅

  • min() - Находит наимСньшСС Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅
  • count() - ΠŸΠΎΠ΄ΡΡ‡ΠΈΡ‚Ρ‹Π²Π°Π΅Ρ‚ количСство элСмСнтов Π² массивС ΠΈΠ»ΠΈ Π² ΠΎΠ±ΡŠΠ΅ΠΊΡ‚Π΅ Countable
οΌ‹Π”ΠΎΠ±Π°Π²ΠΈΡ‚ΡŒ

ΠŸΡ€ΠΈΠΌΠ΅Ρ‡Π°Π½ΠΈΡ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Π΅ΠΉ 12 notes

up
70
keith at bifugi dot com ΒΆ
9 years ago
The simplest way to get around the fact that max() won't give the key is array_search:

<?php
$student_grades = array ("john" => 100, "sarah" => 90, "anne" => 100);
$top_student = array_search(max($student_grades),$student_grades); // john
?>

This could also be done with array_flip, though overwriting will mean that it gets the last max value rather than the first:

<?php
$grades_index = array_flip($student_grades);
$top_student = $grades_index[max($student_grades)]; // anne
?>

To get all the max value keys:

<?php
$top_students = array_keys($student_grades,max($student_grades)); // john, anne
?>
up
13
deoomen ΒΆ
3 years ago
Watch out after PHP 8.0!

Sample code:

<?php
echo max(0,'hello');
?>

Before PHP 8.0 will return int(0) but since PHP 8.0 above code returns string("hello")!!
up
21
volch5 at gmail dot com ΒΆ
12 years ago
max() (and min()) 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
4
Samu ΒΆ
2 years ago
With modern PHP versions supporting the array spread operator for function arguments, it's tempting to call max() like this:

<?php
function stuff(): iterable {
    // This function might yield 0, 1 or n values.
}

$foo = max(...stuff());
?>

However, this is dangerous if you cannot guarantee that your generator yields **minimum** two values.

The gotcha here is that when max() receives a single argument, it must be an array of values. (When the generator doesn't yield any values, max() will throw an ArgumentCountError.)

If you can guarantee that your generator yields at least one value, then it's safe to call max by relying on the aforementioned array expectation:

<?php
function stuff(): iterable {
    // This function will yield 1...n values.
}

// Note that here the generator is first read into an array.
$foo = max([...stuff()]);
?>

If the array is empty, max() will throw a ValueError.

The added burden is that faulty code could appear to appear to function just fine but fails at random, probably causing a lot of head-scratching at first.
up
18
costinu ΒΆ
14 years ago
max(null, 0) = null
max(0, null) = 0
up
14
Alex Rath ΒΆ
16 years ago
Notice that whenever there is a Number in front of the String, it will be used for Comparison.

<?php

  max('7iuwmssuxue', 1); //returns 7iuwmssuxu
  max('-7suidha', -4); //returns -4

?>

But just if it is in front of the String

<?php

  max('sdihatewin7wduiw', 3); //returns 3

?>
up
6
johnphayes at gmail dot com ΒΆ
20 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
6
ries at vantwisk dot nl ΒΆ
17 years ago
I had several occasions that using max is a lot slower then using a if/then/else construct. Be sure to check this in your routines!

Ries
up
7
marcini ΒΆ
17 years ago
Note that max() can compare dates, so if you write something like this:

<?php
$dates = array('2009-02-15', '2009-03-15');
echo max($dates);
?>

you will get: 2009-03-15.
up
2
michaelangel0 at mail.com ΒΆ
18 years ago
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:

<?php
function doublemax($mylist){
  $maxvalue=max($mylist);
  while(list($key,$value)=each($mylist)){
    if($value==$maxvalue)$maxindex=$key;
  }
  return array("m"=>$maxvalue,"i"=>$maxindex);
}
?>
up
0
blackmac01 at gmail dot com ΒΆ
6 years ago
In response to: keith at bifugi dot com

If you want to find the specific key(s) that match the maximum value in an array where the values may be duplicated, you can loop through and perform a simple check:
<?php

# Example Array
$a = array(
     'key1' => 100,
     'key2' => 90,
     'key3' => 100,
     'key4' => 90,
);

# First get the maximum value
$max = max($a);

# Create a new array containing all keys which have the max value
foreach($a as $key => $val) {     
     if($val === $max) $b[] = $key;
}

# If you want a string list, just do this
$b = implode(' ', $b);
?>

This produces consistent results and will scale well in terms of performance, whereas functions like array_search and array_flip can lead to degraded performance when dealing with large amounts of data.
up
-2
info at osworx dot net ΒΆ
7 years ago
Be aware if a array like this is used (e.g. values from a shopping cart):
<?php
Array
(
    [0] => 142,80
    [1] => 39,27
    [2] => 22,80
    [3] => 175,80
)?>
The result will be: 39,27 and not - as expected - 175,80

So, to find the max value, use integer only like:
<?php
Array
(
    [0] => 14280
    [1] => 3927
    [2] => 2280
    [3] => 17580
)?>
and you will get the correct result: 17580