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

Copy
1<?php
2
3/**
4 * 指定された値がnullではないかを判定します。
5 *
6 * PHPの内部定数である `T_IS_NOT_EQUAL` は、`!=` (等しくない) 演算子を意味します。
7 * この関数では、`T_IS_NOT_EQUAL` が表す `!=` 演算子を使用して、値がnullではないかをチェックします。
8 *
9 * 補足: PHPでは、通常、値がnullであることを厳密にチェックするために `!== null` を使用することが推奨されます。
10 * `!= null` は緩い比較であり、例えば `0 != null` や `false != null` はどちらも `true` となりますが、
11 * `T_IS_NOT_EQUAL` との関連性を示すため、ここでは `!= null` を使用しています。
12 *
13 * @param mixed $value 判定する値。PHP 8以降では様々な型を受け入れます。
14 * @return bool nullでなければ true、nullであれば false を返します。
15 */
16function isValueNotNull(mixed $value): bool
17{
18    // T_IS_NOT_EQUALが表す「!=」演算子を使って、値がnullではないかを判定します。
19    return $value != null;
20}
21
22// --- サンプルコードの使用例 ---
23
24// 各種テスト値
25$testString = "Hello PHP";    // 文字列
26$testNull = null;             // null値
27$testZero = 0;                // 数値の0
28$testFalse = false;           // 論理値のfalse
29$testEmptyString = "";        // 空文字列
30$testArray = [];              // 空の配列
31
32echo "--- isValueNotNull() 関数の動作確認 ---" . PHP_EOL;
33
34echo "値 " . var_export($testString, true) . " はnullではないか？: " . (isValueNotNull($testString) ? "はい" : "いいえ") . PHP_EOL;
35echo "値 " . var_export($testNull, true) . " はnullではないか？: " . (isValueNotNull($testNull) ? "はい" : "いいえ") . PHP_EOL;
36echo "値 " . var_export($testZero, true) . " はnullではないか？: " . (isValueNotNull($testZero) ? "はい" : "いいえ") . PHP_EOL;
37echo "値 " . var_export($testFalse, true) . " はnullではないか？: " . (isValueNotNull($testFalse) ? "はい" : "いいえ") . PHP_EOL;
38echo "値 " . var_export($testEmptyString, true) . " はnullではないか？: " . (isValueNotNull($testEmptyString) ? "はい" : "いいえ") . PHP_EOL;
39echo "値 " . var_export($testArray, true) . " はnullではないか？: " . (isValueNotNull($testArray) ? "はい" : "いいえ") . PHP_EOL;
40

このPHPサンプルコードは、指定された値がnull（何もない状態）ではないかを判定するisValueNotNull関数について説明しています。T_IS_NOT_EQUALはPHPの内部で!=（等しくない）演算子を表す定数であり、この関数はその!=演算子を利用して、引数として渡された$valueがnullと等しくないかを判断します。引数の$valueはmixed型で、PHP 8以降では様々な型の値を受け入れることができます。戻り値はbool型で、値がnullでなければtrueを、nullであればfalseを返します。

特に、!= nullという比較は「緩やかな比較」であり、例えば数値の0や論理値のfalse、空文字列などもnullではないと判定します。PHPでは通常、値がnullであるかを厳密に判定するために!== nullという「厳密な比較」が推奨されますが、このサンプルコードではT_IS_NOT_EQUALが示す!=演算子の動作を示す目的で!= nullを使用しています。コードの後半では、文字列、null、0、falseなど多様な値を使ってisValueNotNull関数の動作を確認しており、これらの結果を通じて!= null演算子の具体的な挙動を理解することができます。

Copy
1<?php
2
3/**
4 * 指定されたPHPコードを解析し、そのトークン情報を表示します。
5 * T_IS_NOT_EQUAL (不等号演算子) と T_STRING (識別子) トークンに注目します。
6 *
7 * @param string $phpCode 解析対象のPHPコード文字列。
8 */
9function analyzePhpCodeTokens(string $phpCode): void
10{
11    echo "--- 解析対象のPHPコード ---" . PHP_EOL;
12    echo $phpCode . PHP_EOL;
13    echo "---------------------------" . PHP_EOL . PHP_EOL;
14
15    // token_get_all() 関数は、PHPコードをトークンの配列に分割します。
16    // 各トークンは、そのID (整数)、内容 (文字列)、行番号 (整数) を含む配列、
17    // または単一文字の文字列 (例: '{', '}', ';') として返されます。
18    $tokens = token_get_all($phpCode);
19
20    echo "--- トークン分析結果 ---" . PHP_EOL;
21
22    foreach ($tokens as $token) {
23        if (is_array($token)) {
24            // トークンが配列形式の場合（ID, 内容, 行番号）
25            $tokenId = $token[0];      // トークンID (例: T_IS_NOT_EQUAL の整数値)
26            $tokenContent = $token[1]; // トークンの内容 (例: '!=', '$a', 'echo')
27            $lineNumber = $token[2];   // コード中の行番号
28
29            // token_name() 関数を使って、トークンIDを可読な文字列名に変換します。
30            $tokenName = token_name($tokenId);
31
32            echo sprintf(
33                "  [ID: %d (%s), 内容: '%s', 行: %d]",
34                $tokenId,
35                $tokenName,
36                $tokenContent,
37                $lineNumber
38            ) . PHP_EOL;
39
40            // T_IS_NOT_EQUAL は、'!=' や '<>' のような「等しくない」演算子を表すトークンです。
41            if ($tokenId === T_IS_NOT_EQUAL) {
42                echo "    => 発見！T_IS_NOT_EQUAL (不等号演算子) トークン" . PHP_EOL;
43            }
44
45            // T_STRING は、変数名、関数名、クラス名などの識別子を表すトークンです。
46            if ($tokenId === T_STRING) {
47                echo "    => 発見！T_STRING (識別子) トークン" . PHP_EOL;
48            }
49        } else {
50            // トークンが文字列形式の場合 (例: '{', '}', ';', 空白など)
51            echo "  [内容: '" . $token . "']" . PHP_EOL;
52        }
53    }
54    echo "--------------------------" . PHP_EOL;
55}
56
57// サンプルPHPコードを定義します。
58// このコードには '!=' 演算子と様々な文字列（識別子）が含まれています。
59$samplePhpCode = <<<'CODE'
60<?php
61$valueA = 10;
62$valueB = 20;
63
64if ($valueA != $valueB) { // ここに T_IS_NOT_EQUAL があります
65    echo "値は等しくありません。"; // ここに T_STRING 'echo' と '値は等しくありません。' があります
66}
67
68function greet(string $name): void { // ここに T_STRING 'function', 'greet', 'string', 'name', 'void' があります
69    echo "Hello, " . $name . "!";
70}
71
72greet("PHP User");
73CODE;
74
75// 関数を実行して、サンプルPHPコードのトークンを分析します。
76analyzePhpCodeTokens($samplePhpCode);
77
78?>

このPHPコードは、与えられたPHPソースコードを「トークン」という最小単位に分解し、その種類や内容を分析して表示します。

中心となるtoken_get_all()関数は、PHPコード文字列を引数にとり、解析結果としてトークン情報の配列を返します。各トークンは、ID（整数値）、内容、行番号などを含みます。

T_IS_NOT_EQUALは、PHPコード中の「等しくない」演算子（!=や<>）を示すトークンID（整数値）です。サンプルコードではif ($valueA != $valueB)内の!=を検出します。

T_STRINGは、変数名、関数名、クラス名などの「識別子」を示すトークンIDです。$valueA、greet、echoといった要素がこれに該当します。

token_name()関数は、数値であるトークンIDをT_IS_NOT_EQUALのような可読な名前に変換するために利用されます。この解析技術は、構文チェックや静的解析、IDEのコード補完機能などの基盤となります。