min
(PHP 4, PHP 5, PHP 7)
min — Находит наименьшее значение
Описание
Если в качестве аргументов передан только один - массив чисел, min() возвращает наименьшее из них. Если первый аргумент - integer или float, то обязательно должен быть хотя бы ещё один. В этом случае функция min() вернёт наименьшее из них.
Замечание:
Значения разных типов сравниваются с использованием стандартных правил сравнения. Например, не числовая строка (string) будет сравниваться с целым числом (integer) как будто она равна 0, но несколько строк (string) будут сравниваться по алфавиту. Возвращаемое значение сохранит первоначальный тип переменной, без преобразования.
Список параметров
Возвращаемые значения
Функция min() возвращает значение того параметра, который считается "самым маленьким" согласно стандартным правилам сравнения. Если несколько значений разного типа равны между собой (т.е. 0 и 'abc'), то будет возвращен первый из них.
Примеры
Пример #1 Пример использования min()
<?php
echo min(2, 3, 1, 6, 7); // 1
echo min(array(2, 4, 5)); // 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(2, 2, 2), array(1, 1, 1, 1)); // array(2, 2, 2)
// Несколько массивов одинаковой длины сравниваются слева направо
// для этого примера: 2 == 2, но 4 < 5
$val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8)
// Если сравниваются массив и не-массив, то массив никогда не будет возвращен
// так как массивы считаются большими чем все остальные значения
$val = min('string', array(2, 5, 7), 42); // string
// Если один аргумент является NULL или булевым, то он будет сравниваться с остальными
// с использованием правило FALSE < TRUE, учитывая остальные типы аргументов
// В приведенном примере -10 и 10 рассматриваются как TRUE
$val = min(-10, FALSE, 10); // FALSE
$val = min(-10, NULL, 10); // NULL
// с другой стороны, 0 рассматривается как FALSE, поэтому это "меньше" чем TRUE
$val = min(0, TRUE); // 0
?>
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Математические расширения
- Математические функции
- abs
- acos
- acosh
- asin
- asinh
- atan2
- atan
- atanh
- base_convert
- bindec
- ceil
- cos
- cosh
- decbin
- dechex
- decoct
- deg2rad
- exp
- expm1
- floor
- fmod
- getrandmax
- hexdec
- hypot
- intdiv
- is_finite
- is_infinite
- is_nan
- lcg_value
- log10
- log1p
- log
- max
- min
- mt_getrandmax
- mt_rand
- mt_srand
- octdec
- pi
- pow
- rad2deg
- rand
- round
- sin
- sinh
- sqrt
- srand
- tan
- tanh
Коментарии
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 !
min() (and max()) 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