【PHP8.x】is_long関数の使い方

Copy
1<?php
2
3/**
4 * 指定された値が整数型（long）であるかどうかを is_long() 関数で判定し、結果を表示します。
5 *
6 * is_long() は is_int() のエイリアスであり、PHP 8 時点では非推奨ではありません。
7 *
8 * @param mixed $value テストする値。
9 * @return void
10 */
11function demonstrateIsLong(mixed $value): void
12{
13    // 値の型を取得します
14    $type = gettype($value);
15    // is_long() 関数で値が整数型（long）であるか判定します
16    $isLongResult = is_long($value);
17
18    // 結果を出力します
19    echo "テスト値: " . var_export($value, true) . " (実際の型: {$type})\n";
20    echo "is_long() の結果 (整数型であるか): " . ($isLongResult ? "はい" : "いいえ") . "\n";
21    echo "----------------------------------------\n";
22}
23
24// 様々なデータ型で demonstrateIsLong 関数を呼び出し、動作を確認します。
25demonstrateIsLong(123);           // 整数
26demonstrateIsLong(-456);          // 負の整数
27demonstrateIsLong(0);             // ゼロ
28demonstrateIsLong(PHP_INT_MAX);   // PHPで表現可能な最大整数値
29demonstrateIsLong(123.45);        // 浮動小数点数
30demonstrateIsLong("123");         // 数値に見える文字列
31demonstrateIsLong("hello");       // 文字列
32demonstrateIsLong(true);          // 真偽値 (true)
33demonstrateIsLong(false);         // 真偽値 (false)
34demonstrateIsLong(null);          // NULL値
35demonstrateIsLong([]);            // 配列
36demonstrateIsLong(new stdClass());// オブジェクト

is_long()関数は、プログラミングにおいて、指定された値が整数型（integer）であるかどうかを判定するために使用されます。引数mixed $valueには、判定したい任意のデータ型の値を指定します。この関数は、引数が純粋な整数型であればtrue（真）を、そうでなければfalse（偽）を真偽値として返します。

PHPでは、is_long()はis_int()関数のエイリアス（別名）として提供されており、どちらを使っても同じ結果が得られます。PHP 8の時点では、この関数は非推奨（deprecated）ではありませんので、コード内で安全に利用することができます。

サンプルコードでは、demonstrateIsLongという補助関数を通じて、様々なデータ型（整数、浮動小数点数、文字列、真偽値など）の値をis_long()関数でテストしています。例えば、123やPHP_INT_MAXのような実際の整数値に対してはtrueが返されますが、123.45のような浮動小数点数、"123"のような数値に見える文字列、trueやfalseといった真偽値、配列、オブジェクトなど、整数型以外の値に対してはすべてfalseが返される動作が確認できます。

このように、is_long()関数は、プログラム内で値の型に基づいて処理を分岐させたい場合に、特定の変数が整数型であるかを簡単かつ明確に判定するのに役立ちます。

Copy
1<?php
2
3/**
4 * is_long() 関数の使い方をデモンストレーションします。
5 * PHPは進化し続けていますが、is_long() (is_int() のエイリアス) のような基本的な型チェック関数は
6 * 今も変わらず利用可能で、堅牢なコードを書く上で重要です。
7 */
8function demonstrateIsLongFunction(): void
9{
10    echo "--- is_long() 関数のデモンストレーション ---" . PHP_EOL . PHP_EOL;
11
12    // 整数 (内部的にlong型として扱われる)
13    $integerValue = 123;
14    echo "値: " . var_export($integerValue, true) . " -> is_long(): " . (is_long($integerValue) ? "true" : "false") . PHP_EOL;
15
16    // 大きな整数 (64ビット環境での最大値の一例)
17    $largeLongValue = 9223372036854775807;
18    echo "値: " . var_export($largeLongValue, true) . " -> is_long(): " . (is_long($largeLongValue) ? "true" : "false") . PHP_EOL;
19
20    // 浮動小数点数
21    $floatValue = 12.34;
22    echo "値: " . var_export($floatValue, true) . " -> is_long(): " . (is_long($floatValue) ? "true" : "false") . PHP_EOL;
23
24    // キーワード「long」を含む文字列
25    $longString = "long live PHP!";
26    echo "値: " . var_export($longString, true) . " -> is_long(): " . (is_long($longString) ? "true" : "false") . PHP_EOL;
27
28    // 数値に見えるが文字列型
29    $numericString = "456";
30    echo "値: " . var_export($numericString, true) . " -> is_long(): " . (is_long($numericString) ? "true" : "false") . PHP_EOL;
31
32    // 論理値
33    $booleanValue = true;
34    echo "値: " . var_export($booleanValue, true) . " -> is_long(): " . (is_long($booleanValue) ? "true" : "false") . PHP_EOL;
35
36    // null
37    $nullValue = null;
38    echo "値: " . var_export($nullValue, true) . " -> is_long(): " . (is_long($nullValue) ? "true" : "false") . PHP_EOL;
39
40    echo PHP_EOL . "PHPは多くのデータ型を扱いますが、is_long() は値が真の整数型であるかを厳密にチェックします。" . PHP_EOL;
41}
42
43// 関数を実行します。
44demonstrateIsLongFunction();

PHPのis_long()関数は、与えられた変数が整数型（int型）であるかを厳密に判定するために使用されます。この関数はis_int()関数のエイリアス（別名）として機能し、どちらを使用しても同様の結果を得られます。

引数にはmixed $valueとあり、整数、浮動小数点数、文字列、論理値、nullなど、どのような型の変数でも渡すことが可能です。この関数は渡された値が純粋な整数である場合にのみtrue（真）を返し、それ以外の型である場合はfalse（偽）を返します。

例えば、123や9223372036854775807のような整数値はtrueと判定されます。しかし、12.34のような浮動小数点数、"456"のように数値に見える文字列、trueのような論理値、nullなど、整数ではない値はすべてfalseと判定されます。

この関数は、プログラム内で特定の処理が整数値にのみ適用されるべき場合や、ユーザーからの入力が期待通りの型であるかを検証する際に非常に役立ちます。変数の型を明確に確認することで、予期せぬエラーを防ぎ、より堅牢で信頼性の高いコードを記述することができます。