(PHP 4, PHP 5, PHP 7, PHP 8)
min — 最小値を返す
代替のシグネチャ (名前付き引数をサポートしていません):
パラメータとして配列をひとつだけ渡した場合は、 min() は配列の中で最も小さい数値を返します。 ふたつ以上のパラメータを指定した場合は、min() はそれらの中で最も小さいものを返します。
注意:
異なる型の値を比較する際には、 標準の比較ルールに従います。 たとえば、数値形式でない string を int と比較するときには、数値
0と評価します。 しかし、数値形式でない string どうしを比較するときには、アルファベット順で評価します。 返される値は、何も変換をしていない、元の型の値となります。
異なる型の値を引数として渡す際には注意しましょう。 min() が予期せぬ結果を返す可能性があるからです。
min() は、パラメータとして渡した値の中で、標準の比較ルールに従って最小になるものを返します。
異なる型で同じ値と評価される複数の値 (0 と 'abc' など)
があった場合は、関数に最初に渡されたほうを返します。
min() に空の配列を渡すと、 ValueError をスローします。
| バージョン | 説明 |
|---|---|
| 8.0.0 |
min() は失敗した場合に、
ValueError をスローするようになりました。
これより前のバージョンでは、false を返し、
E_WARNING レベルのエラーが発生していました。
|
| 8.0.0 | 文字列と数値の比較方法が変更された ため、 数値と非数値形式の文字列を比較した場合に、引数の順番に応じて異なる値を返さなくなりました。 |
例1 min() の例
<?php
echo min(2, 3, 1, 6, 7), PHP_EOL; // 1
echo min(array(2, 4, 5)), PHP_EOL; // 2
// -1 と 0 の比較なので、-1 のほうが小さくなります
echo min('hello', -1), PHP_EOL; // -1
// 長さが異なる複数の配列を渡すと、いちばん短い配列を返します
$val = min(array(2, 2, 2), array(1, 1, 1, 1)); // array(2, 2, 2)
var_dump($val);
// 同じ長さの複数の配列を渡すと、max はその要素を左から
// 辞書順に比較します。この例では 2 == 2 ですが 4 < 5 となります
$val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8)
var_dump($val);
// 配列と配列でない値が渡された場合、常に
// 配列が最大と判定されます。
$val = min('string', array(2, 5, 7), 42); // string
var_dump($val);
// 一方の値が NULL や boolean の場合、それを他の値と比較するときには、
// もう一方の値の型が何であるかにかかわらず、
// FALSE < TRUE / NULL == FALSE というルールを使います。
// 以下の例では、-10 と 10 はどちらも TRUE と評価されます。
$val = min(-10, FALSE, 10); // FALSE
var_dump($val);
$val = min(-10, NULL, 10); // NULL
var_dump($val);
// 一方 0 は FALSE と評価されるので、TRUE よりは小さいとみなされます。
$val = min(0, TRUE); // 0
var_dump($val);
?>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