max
(PHP 4, PHP 5)
max — 最大値を返す
説明
パラメータとして配列をひとつだけ渡した場合は、max() は配列の中で最も大きい数値を返します。 ふたつ以上のパラメータを指定した場合は、max() はそれらの中で最も大きいものを返します。
注意:
PHP は、数値として解釈できない string を integer と比較する場合には 0 と評価します。しかし、もしそれが最大値であった 場合、返り値はもとの文字列となります。0 と評価される 引数が複数存在した場合、max() はもしその中に 数値の 0 があればそれを返し、そうでなければ アルファベット順で一番大きな文字列の値が返されます。
返り値
max() は、パラメータとして渡した値の中で 数値として最も大きいものを返します。 同じ大きさの値が複数あった場合は、最初にあらわれたものを返します。
max() に複数の配列を渡した場合は、いちばん長い配列を返します。 すべての配列が同じ長さの場合は、辞書順の並べ替えで返り値を見つけます。
文字列を渡した場合は、integer に変換してから比較します。
例
例1 max() の使用例
<?php
echo max(1, 3, 5, 6, 7); // 7
echo max(array(2, 4, 5)); // 5
// 'hello' を integer に変換すると 0 になります。ふたつのパラメータの長さは
// 等しくなるので、パラメータを渡した順によって結果が決まります
echo max(0, 'hello'); // 0
echo max('hello', 0); // hello
echo max('42', 3); // '42'
// 0 > -1 なので、返り値は 'hello' となります
echo max(-1, 'hello'); // hello
// 長さが異なる複数の配列を渡すと、いちばん長い配列を返します
$val = max(array(2, 2, 2), array(1, 1, 1, 1)); // array(1, 1, 1, 1)
// 同じ長さの複数の配列を渡すと、max はその要素を左から
// 辞書順に比較します。この例では 2 == 2 ですが 4 < 5 となります
$val = max(array(2, 4, 8), array(2, 5, 7)); // array(2, 5, 7)
// 配列と配列でない値が渡された場合、常に
// 配列が最大と判定されます。
$val = max('string', array(2, 5, 7), 42); // array(2, 5, 7)
?>
