ITコラム

PHP

2019.03.04

PHP【配列】in_array で値の存在チェック

PHP には配列内に指定した値があるかどうかをチェックする in_array 関数があります。
今回は in_array 関数の使用方法を紹介します。

配列についてはこちらの記事もご参照下さい。

PHP【配列】複数の値を保持するデータ構造
 PHP【配列】配列にデータを追加
 PHP【配列】配列からデータを削除
 PHP【配列】count で要素数を取得
 PHP【配列】配列のソート
 PHP【連想配列】キーでデータを特定
 PHP【多次元配列】配列の中に配列
 PHP【配列】配列内のデータ検索
 PHP【配列】要素を比較
 PHP【配列】配列の結合
 PHP【配列】in_array で値の存在チェック（本ページ）
PHP【配列】array_map で一括処理
 PHP【配列】キーを取得
 PHP【配列】array_filter でフィルター
 PHP【配列】array_column で同一キーの値を取得
 PHP【配列】foreach でループ処理
 PHP【配列】array_unique で重複した値を削除
 PHP【配列】便利な関数

　
尚、本サイトでは XAMPP（ザンプ）という開発環境を使用しています。
XAMPP のインストール方法や起動方法については以下の記事をご参照下さい。
PHP【開発環境】XAMPP インストール
 PHP【開発環境】XAMPP の使い方

最終更新日：2019年3月4日

１．in_array 関数

　
in_array 関数は、配列内に指定した値が存在するか否かを true 又は false で返す関数です。

in_array 関数は次のように記述して使用します。

in_array ( 値 , $array [ , true / false ]) ;

第 1 引数にはチェックする値を指定します。
文字列の値を指定する場合は、大文字と小文字は区別されます。

第 2 引数にはチェックの対象となる配列を指定します。

第 3 引数はチェックの厳格さについての指定で、ここに true を指定するとチェックする値のデータ型やオブジェクトが同じインスタンスであるか等まで比較対象となります（省略可）。

▲目次へ戻る

２．in_array のサンプル

　
in_array 関数を使用して配列内に特定の値があるかどうかチェックしてみます。

下記のようなソースファイルを作成してブラウザからアクセスすると、次のような表示になります。
（ソースファイルの作成方法についてはソースファイルを作成を、サーバの起動方法等についてはサーバを起動を、それぞれご参照下さい。）

<pre>
<?php

  $ary1 = array("ホノルル", "ロサンゼルス");
  $ary2 = array("NYC"=>"ニューヨーク", "CHI"=>"シカゴ");

  var_dump(in_array("ハワイ", $ary1));
  var_dump(in_array("ホノルル", $ary1));
  var_dump(in_array("ロス", $ary1));

  echo "<br><br>";

  var_dump(in_array("NYC", $ary2));
  var_dump(in_array("CHI", $ary2));
  var_dump(in_array("シカゴ", $ary2));

?>
</pre>

配列変数 $ary1、$ary2 に指定した値が存在する場合は true 、存在しない場合は false が返っています。

連想配列に関しても使用方法は一緒です。
　

var_dump

「 var_dump 」は、引数に指定したデータを詳細に出力する PHP の関数です。

PHP では、bool 型（ true / false ）のデータを echo 等で出力すると、true の場合は「 1 」が表示され、false の場合は何も表示されないため判定結果が分かりづらいのですが、var_dump 関数を使用して出力すると「 bool(false) 」のように、出力対象のデータ型と出力内容が分かり易く表示されます。

var_dump 関数は、「 var_dump(出力データ); 」のように記述して使用します。

var_dump 関数で文字列や配列のデータを出力すると「 string(3) “HNL” 」「 array(4) { [0]=>string(3) “HNL” ･･･ } 」のようにデータのサイズも表示されるので便利です。

▲目次へ戻る

３．in_array の不具合回避

　
次のような配列で in_array 関数を使用すると、一般的な期待値とは違う結果になることがあります。

<pre>
<?php

  $ary3 = array(0, "羽田", 1, "成田");

  var_dump(in_array("NRT", $ary3));
  var_dump(in_array(2, $ary3));
  var_dump(in_array("羽田", $ary3));

?>
</pre>

配列変数 $ary3 に「 NRT 」という値は存在しませんが、in_array の実行結果として true が返っています。

これは、in_array 関数が実行される際に自動的にデータ型の変換が行われることに起因する不具合で、上のサンプルのように数値データ（特に 0 ）が絡む場合に生じます。

この不具合を解消するためには、in_array 関数の第 3 引数に true を指定すると効果的です。

<pre>
<?php

  $ary3 = array(0, "羽田", 1, "成田");

  var_dump(in_array("NRT", $ary3, true));
  var_dump(in_array(2, $ary3, true));
  var_dump(in_array("羽田", $ary3, true));

?>
</pre>