【PHP8.x】is_bool()関数の使い方

Copy
1<?php
2
3// is_bool()関数は、与えられた変数がブール型 (true または false) であるかをチェックします。
4// 結果はブール値 (true または false) で返されます。
5
6// さまざまな型の値を定義します
7$valueTrue = true;          // ブール型 (bool)
8$valueFalse = false;        // ブール型 (bool)
9$valueInt = 0;              // 整数型 (int)
10$valueString = "true";      // 文字列型 (string)
11$valueNull = null;          // NULL型 (null)
12$valueArray = [];           // 配列型 (array)
13$valueFloat = 0.0;          // 浮動小数点数型 (float)
14
15echo "--- is_bool() 関数の使用例 ---" . PHP_EOL . PHP_EOL;
16
17// 各値がブール値であるかをチェックし、結果を表示します。
18// var_export()で元の値を表示し、var_dump()でis_bool()の戻り値 (型と値) を表示します。
19
20echo '値: ' . var_export($valueTrue, true) . ' => is_bool() の結果: ';
21var_dump(is_bool($valueTrue)); // true が返る (ブール値なので)
22echo PHP_EOL;
23
24echo '値: ' . var_export($valueFalse, true) . ' => is_bool() の結果: ';
25var_dump(is_bool($valueFalse)); // true が返る (ブール値なので)
26echo PHP_EOL;
27
28echo '値: ' . var_export($valueInt, true) . ' => is_bool() の結果: ';
29var_dump(is_bool($valueInt)); // false が返る (整数型はブール値ではない)
30echo PHP_EOL;
31
32echo '値: ' . var_export($valueString, true) . ' => is_bool() の結果: ';
33var_dump(is_bool($valueString)); // false が返る (文字列型はブール値ではない)
34echo PHP_EOL;
35
36echo '値: ' . var_export($valueNull, true) . ' => is_bool() の結果: ';
37var_dump(is_bool($valueNull)); // false が返る (NULL型はブール値ではない)
38echo PHP_EOL;
39
40echo '値: ' . var_export($valueArray, true) . ' => is_bool() の結果: ';
41var_dump(is_bool($valueArray)); // false が返る (配列型はブール値ではない)
42echo PHP_EOL;
43
44echo '値: ' . var_export($valueFloat, true) . ' => is_bool() の結果: ';
45var_dump(is_bool($valueFloat)); // false が返る (浮動小数点数型はブール値ではない)
46echo PHP_EOL;
47

PHP 8のis_bool()関数は、与えられた変数のデータ型が厳密にブール型（trueまたはfalse）であるかを判定するために使用されます。この関数には、チェックしたい任意の型の値（mixed $value）を引数として渡すことができます。

is_bool()の戻り値はブール型で、引数に指定した値がブール型そのものであればtrueを返します。もし引数が整数型、文字列型、NULL型、配列型、浮動小数点数型など、ブール型以外の型であれば、その値が論理的に真とみなされるか偽とみなされるかに関わらず、falseを返します。

サンプルコードでは、trueやfalseといった純粋なブール値を渡した場合にはtrueが返ってくることが確認できます。一方、整数値の0や文字列の"true"、null、空の配列など、PHPの他のコンテキストではブール値に変換されるとfalseやtrueと評価される可能性のある値であっても、is_bool()はそれらがブール型ではないため、全てfalseを返します。

この関数は、特に外部からのデータを受け取る際や、特定の処理を実行する前に変数の型を厳密に確認したい場合に役立ちます。これにより、予期せぬ型の不一致によるエラーを防ぎ、プログラムの堅牢性を高めることができます。

Copy
1<?php
2
3/**
4 * is_bool() 関数の使用例を示すスクリプト。
5 * さまざまな型の値がブール値であるかを確認します。
6 *
7 * システムエンジニアを目指す初心者向けに、結果が分かりやすく表示されます。
8 */
9function demonstrateIsBoolCheck(): void
10{
11    echo "--- PHP is_bool() 関数によるブール値のチェック ---\n";
12    echo "この関数は、引数がブール型 (true または false) である場合にのみ true を返します。\n";
13    echo "--------------------------------------------------\n";
14
15    // テスト用の様々な型の値を定義します
16    $testValues = [
17        '真のブール値' => true,
18        '偽のブール値' => false,
19        '整数 (1)' => 1,
20        '整数 (0)' => 0,
21        '文字列 ("true")' => "true",
22        '文字列 ("false")' => "false",
23        '空文字列' => "",
24        'NULL値' => null,
25        '空の配列' => [],
26        '浮動小数点数 (1.0)' => 1.0,
27        '浮動小数点数 (0.0)' => 0.0,
28    ];
29
30    foreach ($testValues as $name => $value) {
31        $type = gettype($value); // 値の実際の型を取得
32
33        // 出力用に値を整形します
34        $displayValue = match (true) {
35            is_bool($value) => $value ? 'true' : 'false', // ブール値は 'true'/'false' で表示
36            is_string($value) => "'" . $value . "'",     // 文字列はクォーテーションで囲む
37            is_null($value) => 'null',                   // NULLは 'null' と表示
38            is_array($value) => '[]',                    // 配列は '[]' と表示
39            default => (string)$value,                   // その他のスカラー値は文字列に変換
40        };
41
42        if (is_bool($value)) {
43            echo "✅ {$name} (値: {$displayValue}, 型: {$type}) はブール値です。\n";
44        } else {
45            echo "❌ {$name} (値: {$displayValue}, 型: {$type}) はブール値ではありません。\n";
46        }
47    }
48    echo "--------------------------------------------------\n";
49}
50
51// サンプルコードを実行します
52demonstrateIsBoolCheck();
53
54?>

PHPのis_bool()関数は、引数として渡された値が「ブール型」であるかどうかを厳密に判定するために使用される関数です。ブール型とは、true（真）またはfalse（偽）のいずれかの値を持つデータ型のことです。

この関数はmixed $valueという引数を受け取ります。これは、どのような型の値でも渡せることを意味します。そして、引数がブール型であればtrueを、それ以外の型であればfalseを戻り値として返します。

提供されたサンプルコードでは、trueやfalseといった純粋なブール値はもちろんのこと、整数、文字列、NULL、配列、浮動小数点数など、様々な種類の値に対してis_bool()関数を適用し、その結果を確認しています。例えば、PHPでは整数1は条件式などではtrueと同じように扱われることがありますが、is_bool()関数はそれがブール型ではないためfalseを返します。同様に、文字列"true"や"false"も、見た目は似ていますがブール型ではないためfalseと判定されます。

このように、is_bool()関数は値の内容だけでなく、その「型」がブール型であるかどうかに焦点を当てて判定するため、意図しない型変換を防ぎ、堅牢なコードを記述する上で非常に役立ちます。

Copy
1<?php
2
3/**
4 * is_bool() 関数の使用例を示します。
5 *
6 * この関数は、さまざまな型の変数がブール型 (true または false) であるかを確認し、
7 * その結果を出力します。システムエンジニアを目指す初心者の方にも、
8 * PHPの型判定がどのように機能するかを理解してもらえるよう、具体的な例を用いています。
9 */
10function demonstrateIsBoolUsage(): void
11{
12    echo "--- is_bool() 関数の使用例 ---" . PHP_EOL;
13    echo "変数がブール型 (true または false) であるかを判定します。" . PHP_EOL . PHP_EOL;
14
15    // さまざまな型の変数を定義
16    $valueTrue = true;
17    $valueFalse = false;
18    $valueInt = 123;
19    $valueZero = 0; // 整数型の0
20    $valueString = "Hello";
21    $valueEmptyString = "";
22    $valueFloat = 3.14;
23    $valueNull = null;
24    $valueArray = [];
25    $valueObject = new stdClass();
26
27    // 各変数に対して is_bool() を実行し、結果を表示
28    echo "\$valueTrue (true): " . (is_bool($valueTrue) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
29    echo "\$valueFalse (false): " . (is_bool($valueFalse) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
30    echo "\$valueInt (123): " . (is_bool($valueInt) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
31    echo "\$valueZero (0): " . (is_bool($valueZero) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
32    echo "\$valueString (\"Hello\"): " . (is_bool($valueString) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
33    echo "\$valueEmptyString (\"\"): " . (is_bool($valueEmptyString) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
34    echo "\$valueFloat (3.14): " . (is_bool($valueFloat) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
35    echo "\$valueNull (null): " . (is_bool($valueNull) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
36    echo "\$valueArray ([]): " . (is_bool($valueArray) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
37    echo "\$valueObject (new stdClass()): " . (is_bool($valueObject) ? "ブール型です" : "ブール型ではありません") . PHP_EOL;
38}
39
40// 関数を実行して使用例を表示
41demonstrateIsBoolUsage();

PHPのis_bool関数は、変数がブール型（trueまたはfalse）であるかを正確に判定するために使用されます。システム開発において、データの型を正しく理解し、処理することは非常に重要です。

この関数は、引数として任意の型の値（mixed $value）を受け取ります。そして、その値が厳密にブール型であればtrueを、それ以外の型であればfalseをブール値として返します。例えば、整数型の0や空文字列などは「偽」として扱われることがありますが、is_bool関数ではこれらはブール型とは判定されません。

サンプルコードでは、trueやfalseといった純粋なブール値だけでなく、整数、文字列、浮動小数点数、null、配列、オブジェクトなど、さまざまな型の変数を用意しています。それぞれの変数に対してis_bool関数を適用し、その結果「ブール型です」または「ブール型ではありません」というメッセージを出力しています。これにより、どの値がブール型として認識されるのかを具体的に確認できます。このコードを通じて、PHPにおける厳密な型判定の挙動を学ぶことができます。