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

Copy
1<?php
2
3/**
4 * is_integer() 関数は、指定された変数が整数型であるかどうかを検査します。
5 * PHP 8 で推奨されるコーディングスタイルに従い、様々なデータ型での動作を示します。
6 */
7
8// 実際の整数値の場合
9$intNumber = 42;
10echo "値: " . $intNumber . " (型: " . gettype($intNumber) . ") -> ";
11echo "is_integer(): " . (is_integer($intNumber) ? "はい" : "いいえ") . PHP_EOL;
12
13// 浮動小数点数の場合 (整数ではない)
14$floatNumber = 3.14;
15echo "値: " . $floatNumber . " (型: " . gettype($floatNumber) . ") -> ";
16echo "is_integer(): " . (is_integer($floatNumber) ? "はい" : "いいえ") . PHP_EOL;
17
18// 文字列の場合 (数字のように見えても整数ではない)
19$stringNumber = "123";
20echo "値: '" . $stringNumber . "' (型: " . gettype($stringNumber) . ") -> ";
21echo "is_integer(): " . (is_integer($stringNumber) ? "はい" : "いいえ") . PHP_EOL;
22
23// 真偽値の場合 (整数ではない)
24$booleanValue = true;
25echo "値: " . ($booleanValue ? "true" : "false") . " (型: " . gettype($booleanValue) . ") -> ";
26echo "is_integer(): " . (is_integer($booleanValue) ? "はい" : "いいえ") . PHP_EOL;
27
28// ゼロの場合 (整数である)
29$zeroValue = 0;
30echo "値: " . $zeroValue . " (型: " . gettype($zeroValue) . ") -> ";
31echo "is_integer(): " . (is_integer($zeroValue) ? "はい" : "いいえ") . PHP_EOL;
32
33// Nullの場合 (整数ではない)
34$nullValue = null;
35echo "値: null (型: " . gettype($nullValue) . ") -> ";
36echo "is_integer(): " . (is_integer($nullValue) ? "はい" : "いいえ") . PHP_EOL;
37
38?>

PHPのis_integer()関数は、引数に渡された変数が「整数型（int）」であるかを検査します。引数mixed $valueにはあらゆる型の値を指定でき、変数が整数型であればtrue（真）を、そうでなければfalse（偽）をbool型で返します。

サンプルコードでは、さまざまなデータ型の値に対してis_integer()関数の挙動を示しています。42や0といった純粋な整数値にはtrueが返されます。しかし、3.14のような浮動小数点数、"123"のような文字列、trueといった真偽値、nullなどの値は、たとえ数値のように見えても、データ型が整数型ではないため、すべてfalseとなります。

これは、is_integer()関数が変数の内容ではなく、その「データ型」が厳密に整数型であるかを判断しているためです。この関数は、プログラム内で変数が間違いなく整数型であることを確認したい場合に役立ちます。

Copy
1<?php
2
3/**
4 * 指定された値が正の整数であるかをチェックします。
5 *
6 * @param mixed $value チェックする値。
7 * @return bool 値が正の整数であれば true、そうでなければ false を返します。
8 */
9function isPositiveInteger(mixed $value): bool
10{
11    // まず、値が整数型であるかを確認します。
12    if (is_integer($value)) {
13        // 整数型であれば、さらにその値が0より大きい（正である）かを確認します。
14        return $value > 0;
15    }
16    // 整数型でなければ、false を返します。
17    return false;
18}
19
20// サンプルコードの実行例
21
22echo "--- 正の整数のテスト ---" . PHP_EOL;
23$number1 = 10;
24echo "{$number1} は正の整数ですか？ " . (isPositiveInteger($number1) ? 'はい' : 'いいえ') . PHP_EOL; // 出力: はい
25
26$number2 = 1;
27echo "{$number2} は正の整数ですか？ " . (isPositiveInteger($number2) ? 'はい' : 'いいえ') . PHP_EOL; // 出力: はい
28
29echo PHP_EOL . "--- その他の値のテスト ---" . PHP_EOL;
30$number3 = 0;
31echo "{$number3} は正の整数ですか？ " . (isPositiveInteger($number3) ? 'はい' : 'いいえ') . PHP_EOL; // 出力: いいえ
32
33$number4 = -5;
34echo "{$number4} は正の整数ですか？ " . (isPositiveInteger($number4) ? 'はい' : 'いいえ') . PHP_EOL; // 出力: いいえ
35
36$floatNumber = 10.5;
37echo "{$floatNumber} は正の整数ですか？ " . (isPositiveInteger($floatNumber) ? 'はい' : 'いいえ') . PHP_EOL; // 出力: いいえ
38
39$string = "10";
40echo "文字列 '{$string}' は正の整数ですか？ " . (isPositiveInteger($string) ? 'はい' : 'いいえ') . PHP_EOL; // 出力: いいえ
41
42$boolean = true;
43echo (string)$boolean . " は正の整数ですか？ " . (isPositiveInteger($boolean) ? 'はい' : 'いいえ') . PHP_EOL; // 出力: いいえ
44
45?>

PHPのis_integer関数は、指定された値が「整数型」であるかどうかを判定するために使われます。この関数はあらゆる型の値（mixed $value）を引数として受け取り、その値が整数型であればtrueを、そうでなければfalseを真偽値（bool）として返します。

サンプルコードでは、このis_integer関数を利用し、「正の整数」であるかをチェックするisPositiveIntegerという独自の関数を定義しています。この関数は、まずis_integer($value)で値が整数型であることを確認します。もし整数型であれば、次にその値が0より大きい（正である）かを判断し、これら二つの条件が両方満たされた場合にのみtrueを返します。それ以外の場合はfalseを返します。

例えば、10や1は正の整数としてtrueと判定されますが、0や-5のような負の整数、10.5のような浮動小数点数、"10"のような文字列、trueのような真偽値は、いずれもfalseと判定されます。このように、is_integer関数は、入力値が特定のデータ型であるかを厳密に確認し、期待する形式のデータだけを処理したい場合に非常に役立つ基本的な関数です。