関数・クラス解説

min

version:PHP 4, PHP 5, PHP 7 (公式)

最小値を返す

公式リファレンス

書式

min ( array $value_array ) : mixed

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

説明

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

注意:

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

警告

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

パラメータ

value_array
値を含む配列。
value
任意の 比較可能な値。
values
任意の 比較可能な値。

返値

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

サンプル

例1 min() の例

echo min(2, 3, 1, 6, 7);  // 1 echo min(array(2, 4, 5)); // 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(2, 2, 2), array(1, 1, 1, 1)); // array(2, 2, 2) // 同じ長さの複数の配列を渡すと、max はその要素を左から // 辞書順に比較します。この例では 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 // 一方の値が NULL や boolean の場合、それを他の値と比較するときには、 // もう一方の値の型が何であるかにかかわらず、 // FALSE < TRUE / NULL == FALSE というルールを使います。 // 以下の例では、-10 と 10 はどちらも TRUE と評価されます。 $val = min(-10, FALSE, 10); // FALSE $val = min(-10, NULL, 10);  // NULL // 一方 0 は FALSE と評価されるので、TRUE よりは小さいとみなされます。 $val = min(0, TRUE); // 0

参考

  • max() - 最大値を返す
  • count() - 変数に含まれるすべての要素、 あるいはオブジェクトに含まれる何かの数を数える
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール