max

(PHP 4, PHP 5)

max — Возвращает наибольшее значение

Описание

mixed max ( array $values )

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

Если в качестве единственного аргумента передан массив, max() вернет значение наибольшее значение из этого массива. Если передано 2 или более аргумента, функция max() вернет наибольший из них.

Замечание:
PHP выразит данные типа string, которые не удалось преобразовать в число как 0 при приведении к типу integer, но вернет строку в случае если она имеет численно более высокое значение. Если несколько аргументов эквивалентны 0, функция max() вернет 0 при численном сравнении, иначе наибольшую строку при сравненииe в смысле строк.

Список параметров

values: Массив с данными.

Возвращаемые значения

max() вернет значение наибольшего из элементов массива. Если несколько параметров имеют одинаковое значение - будет возвращено значение того, который был указан первым.

Если функции max() передано несколько аргументов типа array, будет возвращен массив, в котором большее количество элементов. Если несколько массивов имеют одинаковое количество элементов, то они будут сравниваться поэлементо, слева направо.

При передаче аргумента типа string при сравнении он будет представлен как integer.

Примеры

Пример #1 Пример использования max()


<?php
echo max(1, 3, 5, 6, 7);  // 7
echo max(array(2, 4, 5)); // 5

// 'hello' будет представлено как числое значение значение 0.
// Оба параметра имеют одинаковое значение, поэтому результат
// определяется порядком, в котором параметры переданы 
echo max(0, 'hello');     // 0
echo max('hello', 0);     // hello

echo max('42', 3); // '42'

// В данном случае 0 больше, чем -1, поэтому результат равен 'hello'.
echo max(-1, 'hello');    // hello

// При сравнении массивов, разной длины - max вернет более длинный
$val = max(array(2, 2, 2), array(1, 1, 1, 1)); // array(1, 1, 1, 1)

// При сравнении массивов одинаковой длины - max будет сравнивать их поэлементно
// слева направо, в данном примере 2 == 2, но 4 < 5
$val = max(array(2, 4, 8), array(2, 5, 7)); // array(2, 5, 7)

// Если передан массив и не массив, в результате всегда будет возвращен массив
$val = max('string', array(2, 5, 7), 42);   // array(2, 5, 7)
?>

Смотрите также

min() - Находит наименьшее значение
count() - Подсчитывает количество элементов массива или что-то в объекте