min

(PHP 4, PHP 5, PHP 7, PHP 8)

min最小値を返す

説明

min(mixed $value, mixed ...$values): mixed

代替のシグネチャ (名前付き引数をサポートしていません):

min(array $value_array): mixed

パラメータとして配列をひとつだけ渡した場合は、 min() は配列の中で最も小さい数値を返します。 ふたつ以上のパラメータを指定した場合は、min() はそれらの中で最も小さいものを返します。

注意:

異なる型の値を比較する際には、 標準の比較ルールに従います。 たとえば、数値形式でない stringint と比較するときには、数値 0 と評価します。 しかし、数値形式でない string どうしを比較するときには、アルファベット順で評価します。 返される値は、何も変換をしていない、元の型の値となります。

警告

異なる型の値を引数として渡す際には注意しましょう。 min() が予期せぬ結果を返す可能性があるからです。

パラメータ

value

任意の 比較可能な 値。

values

任意の 比較可能な 複数の値。

value_array

値を含んだ配列。

戻り値

min() は、パラメータとして渡した値の中で、標準の比較ルールに従って最小になるものを返します。 異なる型で同じ値と評価される複数の値 (0'abc' など) があった場合は、関数に最初に渡されたほうを返します。

空の配列を渡した場合は false を返し、 E_WARNING が発生します。

例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

// 長さが異なる複数の配列を渡すと、いちばん短い配列を返します
$val min(array(222), array(1111)); // array(2, 2, 2)

// 同じ長さの複数の配列を渡すと、max はその要素を左から
// 辞書順に比較します。この例では 2 == 2 ですが 4 < 5 となります
$val min(array(248), array(251)); // array(2, 4, 8)

// 配列と配列でない値が渡された場合、常に
// 配列が最大と判定されます。
$val min('string', array(257), 42);   // string

// 一方の値が NULL や boolean の場合、それを他の値と比較するときには、
// もう一方の値の型が何であるかにかかわらず、
// FALSE < TRUE / NULL == FALSE というルールを使います。
// 以下の例では、-10 と 10 はどちらも TRUE と評価されます。
$val min(-10FALSE10); // FALSE
$val min(-10NULL10);  // NULL

// 一方 0 は FALSE と評価されるので、TRUE よりは小さいとみなされます。
$val min(0TRUE); // 0
?>

参考

  • max() - 最大値を返す
  • count() - 配列または Countable オブジェクトに含まれるすべての要素の数を数える

関連キーワード:  min, 最小, 比較, 配列, パラメータ, 数値, 評価, array, 複数, 任意