max

(PHP 4, PHP 5)

max — 最大値を返す

説明

mixed max ( array $values )

mixed max ( mixed $value1 , mixed $value2 [, mixed $value3... ] )

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

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

パラメータ

values: 値を含む配列。

返り値

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)
?>

参考

min() - 最小値を返す
count() - 変数に含まれるすべての要素、あるいはオブジェクトに含まれるプロパティの数を数える