【PHP8.x】T_IS_EQUAL定数の使い方

Copy
1<?php
2
3/**
4 * 指定された値がnullではないことを確認します。
5 * T_IS_EQUAL はPHPの内部トークンであり、'==' (等しい) 演算子を表しますが、
6 * ここではその逆の概念である「nullと等しくない」ことを厳密にチェックします。
7 * システムエンジニアを目指す初心者にとって、値がnullであるかどうかを
8 * 正確に判断することは非常に重要です。
9 *
10 * @param mixed $value チェックする値。PHP 8からはmixed型でどんな型の値でも受け取れます。
11 * @return bool 値がnullでなければtrue、そうでなければfalseを返します。
12 */
13function isValueNotNull(mixed $value): bool
14{
15    // nullではないことを厳密にチェックするために `!== null` を使用します。
16    // これは値と型の両方がnullと異なる場合にtrueを返します。
17    // 例: 0はnullではありません (0 !== null -> true)。空文字列もnullではありません ("" !== null -> true)。
18    return $value !== null;
19}
20
21// --- サンプルコードの使用例 ---
22
23// 様々な値で関数を試します。
24$stringValue = "Hello, PHP 8!";
25$intValue = 123;
26$floatValue = 3.14;
27$boolTrue = true;
28$boolFalse = false;
29$arrayValue = ['a', 'b', 'c'];
30$emptyArray = [];
31$objectValue = new stdClass();
32$nullValue = null;
33$zeroValue = 0; // 0はnullではない
34$emptyString = ""; // 空文字列はnullではない
35
36echo "--- 値がnullではないかのチェック ---" . PHP_EOL;
37
38// 値がnullではない場合の例
39echo "文字列 '{$stringValue}' は null ではないか: " . (isValueNotNull($stringValue) ? "はい" : "いいえ") . PHP_EOL;
40echo "整数 '{$intValue}' は null ではないか: " . (isValueNotNull($intValue) ? "はい" : "いいえ") . PHP_EOL;
41echo "真偽値 'true' は null ではないか: " . (isValueNotNull($boolTrue) ? "はい" : "いいえ") . PHP_EOL;
42echo "空配列は null ではないか: " . (isValueNotNull($emptyArray) ? "はい" : "いいえ") . PHP_EOL;
43echo "オブジェクトは null ではないか: " . (isValueNotNull($objectValue) ? "はい" : "いいえ") . PHP_EOL;
44echo "数値 '{$zeroValue}' (0) は null ではないか: " . (isValueNotNull($zeroValue) ? "はい" : "いいえ") . PHP_EOL;
45echo "空文字列 '{$emptyString}' は null ではないか: " . (isValueNotNull($emptyString) ? "はい" : "いいえ") . PHP_EOL;
46
47echo PHP_EOL; // 区切り
48
49// 値がnullの場合の例
50echo "null値は null ではないか: " . (isValueNotNull($nullValue) ? "はい" : "いいえ") . PHP_EOL;

このサンプルコードは、PHP 8において指定された値がnullではないことを厳密に確認する方法を示しています。T_IS_EQUALはPHPの内部で==（等しい）演算子を表すトークンですが、このコードはその逆の概念である「nullと等しくない」ことを確認します。

定義されたisValueNotNull関数は、mixed型の引数$valueを受け取ります。mixed型はPHP 8から導入され、あらゆる型の値を受け入れられることを示します。この関数は、引数$valueがnullではない場合にtrueを、nullである場合にfalseをbool型で返します。

具体的なチェックには!== nullという厳密な比較演算子を使用しています。これは値だけでなく型もnullと異なる場合にtrueとなるため、例えば数値の0や空文字列""などもnullとは区別され、trueを返します。システム開発において、予期せぬnull値によるエラーを防ぎ、プログラムの安定性を保つため、値がnullであるか否かを正確に判断することは非常に重要です。このサンプルコードは、堅牢なプログラムを作成するための基本的なnullチェックの実践的な方法を提供します。

Copy
1<?php
2
3/**
4 * 変数がnullであるか、またはnullではないかを判定し、その結果を示すメッセージを返します。
5 *
6 * is_null() 関数は、変数が null である場合に true を返します。
7 * ! (論理否定) 演算子を is_null() の結果に適用することで、「nullではない」という条件を表現できます。
8 * 例えば、データベースから取得した値が存在するかどうかをチェックする際などに有用です。
9 *
10 * @param mixed $value チェックする変数。
11 * @return string 判定結果を示すメッセージ。
12 */
13function checkNullOrNotNull(mixed $value): string
14{
15    // !is_null($value) は、「$value が null ではない」という意味になります。
16    if (!is_null($value)) {
17        return "与えられた値は null ではありません: " . var_export($value, true);
18    } else {
19        return "与えられた値は null です。";
20    }
21}
22
23// --- サンプル使用例 ---
24
25echo "--- nullではない値の例 ---\n";
26$dataString = "Hello PHP 8";
27echo checkNullOrNotNull($dataString) . "\n\n";
28
29$dataNumber = 123;
30echo checkNullOrNotNull($dataNumber) . "\n\n";
31
32$dataEmptyString = ""; // 空文字列は null ではありません
33echo checkNullOrNotNull($dataEmptyString) . "\n\n";
34
35echo "--- nullである値の例 ---\n";
36$dataNull = null;
37echo checkNullOrNotNull($dataNull) . "\n\n";
38
39// 未定義の変数は is_null() の引数に直接渡すと警告が出るため、
40// 意図的に null を代入した変数で例を示します。
41// 実際の開発では、isset() や null合体演算子 (??) なども利用されます。
42
43?>

このPHPのサンプルコードは、与えられた変数がnull（ヌル）であるか、あるいはnullではないかを判定する方法をシステムエンジニアを目指す初心者の方にもわかりやすく示しています。

is_null()関数は、引数として渡された変数の値がnullの場合にtrue（真）を返し、それ以外の場合はfalse（偽）を返すPHPの組み込み関数です。ここでいうnullとは、「値がない」状態を意味します。

一方、!（エクスクラメーションマーク）は論理否定演算子と呼ばれ、その後に続く真偽値を反転させる働きがあります。例えば、trueをfalseに、falseをtrueに変換します。

したがって、!is_null($value)という表現は、「$valueがnullではない」という条件を意味します。

サンプルコード内のcheckNullOrNotNull関数は、任意の型の変数（mixed $value）を引数として受け取ります。関数内部では、この!is_null($value)という条件で変数をチェックし、その結果に応じて異なるメッセージを文字列として返します。具体的には、引数がnullではない場合は「与えられた値は null ではありません: ...」、nullである場合は「与えられた値は null です。」というメッセージを戻り値として返します。

この判定方法は、データベースから取得したデータが存在するか確認する際や、特定の変数が初期化されているか否かを判断する際など、システム開発の様々な場面で役立ちます。