PHP in_array() 関数

配列内で値 "Glenn" を検索し、テキストを出力します:

<?php
$people = array("Bill", "Steve", "Mark", "David");
if (in_array("Mark", $people))
  {
  echo "マッチングが見つかりました";
  }
else
  {
  echo "マッチングが見つかりません";
  }
?>

実行例

定義と使用法

in_array() 関数は配列に指定された値が存在するかを検索します。

注釈:もし search パラメータが文字列で type パラメータが TRUE に設定されている場合、検索は大文字と小文字を区別します。

構文

in_array(search,array,type)
パラメータ 説明
search 必須。配列内で検索する値を指定します。
array 必須。検索する配列を指定します。
type オプション。このパラメータを true に設定すると、検索データと配列の値のデータ型が一致するかどうかを確認します。

説明

指定された値が search 配列に存在する array 中で true を返します。もし第3引数が true に設定されている場合、関数は要素が配列内に存在し、データ型が指定された値と一致する場合にのみ true を返します。

パラメータが配列内に見つからない場合、関数は false を返します。

注釈:もし search パラメータが文字列で type パラメータが true に設定されている場合、検索は大文字と小文字を区別します。

技術的詳細

返り値: 配列内に値が見つかった場合 TRUE を返し、見つからない場合 FALSE を返します。
PHP バージョン: 4+
変更履歴: PHP 4.2 以降からsearch パラメータが現在も配列の場合があります。

さらに多くの例

例 1

すべてのパラメータを使用する:

<?php
$people = array("Bill", "Steve", "Mark", "David");
if (in_array("23", $people, TRUE))
  {
  echo "一致する要素が見つかりました<br>";
  }
else
  {
  echo "一致する要素が見つかりません<br>";
  }
if (in_array("Mark",$people, TRUE))
  {
  echo "一致する要素が見つかりました<br>";
  }
else
  {
  echo "一致する要素が見つかりません<br>";
  }
if (in_array(23,$people, TRUE))
  {
  echo "一致する要素が見つかりました<br>";
  }
else
  {
  echo "一致する要素が見つかりません<br>";
  }
?>

実行例