PHPマニュアル/PEARマニュアル | ユーザフォーラムで議論/質問 | マニュアル検索 | ハイライト | ハイライトオフ | ポータル | php spot

max - 最大値を返す | JavaScript入門&応用&リファレンスなら「JavaScriptist」

  

max

(PHP 4, PHP 5, PHP 7)

max最大値を返す

説明

mixed max ( array $values )
mixed max ( mixed $value1 , mixed $value2 [, mixed $... ] )

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

注意:

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

警告

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

パラメータ

values

値を含む配列。

value1

任意の 比較可能な 値。

value2

任意の 比較可能な 値。

...

任意の 比較可能な 値。

返り値

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

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

例1 max() の使用例

<?php
echo max(23167);  // 7
echo max(array(245)); // 5

// 'hello' を int と比較するときは、0 と評価します。ふたつの値が
// 等しくなるので、パラメータを渡した順によって結果が決まります
echo max(0'hello');     // 0
echo max('hello'0);     // hello

// -1 と 0 の比較なので、'hello' のほうが大きくなります
echo max('hello', -1);    // hello

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

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

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

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

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

参考

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


忘却曲線を使ってこの関数を確実に記憶に残す

フォーラムで「max - 最大値を返す」について話す
各種マニュアル: PHPマニュアル | PEARマニュアル | Smarty(英語)マニュアル | PHP-GTKマニュアル | max - 最大値を返す」をGoogle検索
copyright © 1997-2024 PHP ドキュメント作成グループ(ライセンス). provided by php spot. マニュアル: