min

(PHP 3, PHP 4, PHP 5)

min -- 最小値を返す

説明

mixed min ( number arg1, number arg2 [, number ...] )

mixed min ( array numbers )

min() は、パラメータの中で 数値として最も小さいものを返します。

パラメータとして配列をひとつだけ渡した場合は、 min() は 配列の中で最も小さい数値を返します。 最初のパラメータが整数・文字列・倍精度実数の場合は少なくとも 2 つのパラメータが必要であり、 min() はそれらの数値の最も小さいものを返します。 比較する数値の数に制限はありません。

注意: PHP は、数値として解釈できない string0 と評価します。しかし、もしそれが最小値であった 場合、返り値はもとの文字列となります。0 と評価される 引数が複数存在した場合、mix() はもしその中に 文字列があればアルファベット順で一番小さな文字列の値を返し、 そうでなければ数値の 0 が返されます。

例 1. min() の例

<?php
echo min(2, 3, 1, 6, 7);  // 1
echo min(array(2, 4, 5)); // 2

echo min(0, 'hello');     // 0
echo min('hello', 0);     // hello
echo min('hello', -1);    // -1

// 複数の配列を渡すと、mix はその要素を左から順に比較します。
// この例では 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
?>

max() および count() も参照ください。