min

(PHP 4, PHP 5, PHP 7)

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() - Подсчитывает количество элементов массива или что-то в объекте

Коментарии

I tested this with max(), but I suppose it applies to min() too: If you are working with numbers, then you can use:
 
    $a = ($b < $c) ? $b : $c;
 
 which is somewhat faster (roughly 16%) than
 
    $a = min($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.
2004-01-24 09:43:37
http://php5.kiev.ua/manual/ru/function.min.html
Автор:
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 !
2006-01-31 11:37:24
http://php5.kiev.ua/manual/ru/function.min.html
> 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;

It is possible to use it with booleans, there is is just one thing, which you need to keep in mind, when evaluating using the non strict comparison (==) anyting that is not bool false, 0 or NULL is consideret true eg.:
(5 == true) = true;
(0 == true) = false;
true is also actually anything else then 0, false and null. However when true is converted to a string or interger true == 1, therefore when sorting true = 1. But if true is the maximum number bool true is returned. so to be sure, if you only want to match if true is the max number remember to use the strict comparison operater ===
2006-03-16 04:16:46
http://php5.kiev.ua/manual/ru/function.min.html
Be very careful when your array contains both strings and numbers. This code works strange (even though explainable) way:
var_dump(max('25.1.1', '222', '99'));
var_dump(max('2.1.1', '222', '99'));
2007-11-07 10:11:57
http://php5.kiev.ua/manual/ru/function.min.html
Автор:
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
2008-02-21 11:58:49
http://php5.kiev.ua/manual/ru/function.min.html
Автор:
I've modified the bugfree min-version to ignore NULL values (else it returns 0).

<?php
function min_mod () {
 
$args func_get_args();
 
  if (!
count($args[0])) return false;
  else {
   
$min false;
    foreach (
$args[0] AS $value) {
      if (
is_numeric($value)) {
       
$curval floatval($value);
        if (
$curval $min || $min === false$min $curval;
      }
    }
  }
 
  return 
$min;   
}
?>
2008-07-03 06:23:46
http://php5.kiev.ua/manual/ru/function.min.html
A condensed version (and possible application) of returning an array of array keys containing the same minimum value:

<?php
// data
$min_keys = array();
$player_score_totals = array(
'player1' => 300,
'player2' => 301,
'player3' => 302,
'player4' => 301,
...
);

// search for array keys with min() value
foreach($player_score_totals as $playerid => $score)
    if(
$score == min($player_score_totals)) array_push($min_keys$playerid);

print_r($min_keys);
?>
2010-11-13 15:18:08
http://php5.kiev.ua/manual/ru/function.min.html
If NAN is the first argument to min(), the second argument will always be returned.

If NAN is the second argument, NAN will always be returned.

The relationship is the same but inverted for max().

<?php
// \n's skipped for brevity
print max(0,NAN);
print 
max(NAN,0);
print 
min(0,NAN);
print 
min(NAN,0);
?>

Returns:
0
NAN
NAN
0
2010-11-23 15:03:47
http://php5.kiev.ua/manual/ru/function.min.html
Here is function can find min by array key

<?php
function min_by_key($arr$key){
   
$min = array();
    foreach (
$arr as $val) {
        if (!isset(
$val[$key]) and is_array($val)) {
           
$min2 min_by_key($val$key);
           
$min[$min2] = 1;
        } elseif (!isset(
$val[$key]) and !is_array($val)) {
            return 
false;
        } elseif (isset(
$val[$key])) {
           
$min[$val[$key]] = 1;
        }
    }
    return 
minarray_keys($min) );
}
?>
2011-09-26 03:35:15
http://php5.kiev.ua/manual/ru/function.min.html
Автор:
A function that returns the lowest integer that is not 0.
<?php
/* like min(), but casts to int and ignores 0 */
function min_not_null(Array $values) {
    return 
min(array_diff(array_map('intval'$values), array(0)));
}
?>
2013-10-13 19:09:43
http://php5.kiev.ua/manual/ru/function.min.html
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
2014-05-07 19:10:35
http://php5.kiev.ua/manual/ru/function.min.html
Автор:
A min_by function:
<?php
function min_by(Array $arr, Callable $func){
   
$mapped array_map($func$arr);
    return 
$arr[array_search(min($mapped), $mapped)];
}
$a = ["albatross""dog""horse"];
echo 
min_by($a"strlen"); // dog
?>
2017-04-19 18:21:59
http://php5.kiev.ua/manual/ru/function.min.html

    Поддержать сайт на родительском проекте КГБ