Находит наименьшее значение


(PHP 4, PHP 5)

minНаходит наименьшее значение

Описание

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

Если в качестве аргументов передан только один - массив чисел, min() возвращает наименьшее из них. Если первый аргумент - integer или float, то обязательно должен быть хотя бы ещё один. В этом случае функция min() вернёт наименьшее из них.

Замечание:

Значения разных типов сравниваются с использованием стандартных правил сравнения. Например, не числовая строка (string) будет сравниваться с целым числом (integer) как будто она равна 0, но несколько строк (string) будут сравниваться алфивитом. Возвращаемое значение сохранит первоначальный тип переменной, без преобразования.

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

values

Массив содержащий значения.

value1

Любое поддающееся сравнению значение.

value2

Любое поддающееся сравнению значение.

...

Любое поддающееся сравнению значение.

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

Функция min() возвращает значение того параметра, который считается "самым маленьким" согласно стандартным правилам сравнения. Если несколько значений разного типа равны между собой (т.е. 0 и 'abc'), то будет возвращен первый из них.

Примеры

Пример #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

// При сравнении массивов разной длины, min вернет менее длинный
$val min(array(222), array(1111)); // array(2, 2, 2)
 
// Несколько массивов одинаковой длины сравниваются слева направо
// для этого примера: 2 == 2, но 4 < 5
$val min(array(248), array(251)); // array(2, 4, 8)

// Если сравниваются массив и не-массив, то массив никогда не будет возвращен
// так как массивы считаются большими чем все остальные значения
$val min('string', array(257), 42);   // string

// Если один аргумент является NULL или булевым, то он будет сравниваться с остальными
// с использованием правило FALSE < TRUE, учитывая остальные типы аргументов
// В приведенном примере -10 и 10 рассматриваются как TRUE
$val min(-10FALSE10); // FALSE
$val min(-10NULL10);  // NULL

// с другой стороны, 0 рассматривается как FALSE, поэтому это "меньше" чем TRUE
$val min(0TRUE); // 0
?>

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

  • max() - Возвращает наибольшее значение
  • count() - Подсчитывает количество элементов массива или что-то в объекте