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

Copy
1<?php
2
3/**
4 * PHP の ENT_DISALLOWED 定数の使用と、int 型および double 型について説明する関数。
5 * システムエンジニアを目指す初心者向けに、PHP の基本的な数値型を解説します。
6 */
7function demonstratePhpIntAndDoubleTypes(): void
8{
9    echo "--- PHP 定数 ENT_DISALLOWED の確認 ---\n";
10
11    // ENT_DISALLOWED は、HTML エンティティ関連関数（例: htmlspecialchars）で
12    // 無効な文字をどのように処理するかを指定する整数定数です。
13    // この定数の値は整数 (int) 型です。
14    $disallowedConstantValue = ENT_DISALLOWED;
15    echo "ENT_DISALLOWED の値: " . $disallowedConstantValue . "\n";
16    echo "ENT_DISALLOWED の値の型: " . gettype($disallowedConstantValue) . "\n";
17
18    // var_dump() は変数の型と値を含む詳細な情報を表示します。
19    var_dump($disallowedConstantValue);
20
21    echo "\n--- int 型と double 型の理解 ---\n";
22
23    // PHP における int (整数) 型の例。
24    // 整数は小数点を持たない数値です。
25    $integerNumber = 42;
26    echo "整数 (int) の例: " . $integerNumber . ", 型: " . gettype($integerNumber) . "\n";
27    var_dump($integerNumber);
28
29    // PHP における double (浮動小数点数) 型の例。
30    // 浮動小数点数は小数点を持つ数値で、より広範囲の数を表現できます。
31    // PHP では 'float' と 'double' は同じ型として扱われます。
32    $doubleNumber = 3.14159;
33    echo "浮動小数点数 (double) の例: " . $doubleNumber . ", 型: " . gettype($doubleNumber) . "\n";
34    var_dump($doubleNumber);
35
36    echo "\n--- int と double の型変換 ---\n";
37
38    // int から double への型変換。
39    // 整数を浮動小数点数に変換すると、値は保持されますが型が変わります。
40    $convertedToDouble = (double)$integerNumber;
41    echo "int から double へ変換: " . $convertedToDouble . ", 型: " . gettype($convertedToDouble) . "\n";
42    var_dump($convertedToDouble);
43
44    // double から int への型変換。
45    // 浮動小数点数を整数に変換すると、小数点以下の部分は切り捨てられます。
46    $convertedToInt = (int)$doubleNumber;
47    echo "double から int へ変換 (小数点以下は切り捨て): " . $convertedToInt . ", 型: " . gettype($convertedToInt) . "\n";
48    var_dump($convertedToInt);
49}
50
51// 関数を実行して、上記の説明を確認します。
52demonstratePhpIntAndDoubleTypes();

このPHPコードは、ENT_DISALLOWED定数とPHPの基本的な数値型であるint型、double型について初心者向けに解説しています。まず、ENT_DISALLOWEDはHTMLエンティティ関連関数で無効な文字の処理方法を指定するint型の定数です。サンプルコードでは、この定数の値が整数であることをechoやvar_dumpで確認しています。

次に、PHPの数値型についてです。int型は小数点を持たない整数（例: 42）を扱います。対してdouble型は小数点を持つ浮動小数点数（例: 3.14159）を扱い、より広範囲の数値を表現できます。PHPではfloatとdoubleは同じ型として扱われます。

これらの型は相互に変換可能です。int型の値をdouble型に変換すると、値はそのままに型が浮動小数点数になります。一方、double型の値をint型に変換する際には、小数点以下の部分は常に切り捨てられるという特徴があります。このコードは、これらの基本的な数値型とその挙動を理解する手助けとなるでしょう。

Copy
1<?php
2
3/**
4 * 整数除算を行う関数です。
5 * intdiv() 関数は、2つの数値を割った結果の整数部を返します。
6 * PHP 8 環境で動作し、PHP の推奨コーディングスタイルに準拠しています。
7 *
8 * @param int $dividend 被除数
9 * @param int $divisor 除数 (0以外の整数)
10 * @return int 整数除算の結果
11 * @throws DivisionByZeroError 除数が0の場合にスローされます。
12 */
13function calculateIntegerDivision(int $dividend, int $divisor): int
14{
15    // intdiv() 関数は、小数点以下を切り捨てて整数値を返します。
16    // 例: intdiv(10, 3) は 3 を返します。
17    // 例: intdiv(-10, 3) は -3 を返します。
18    // 除数が0の場合、DivisionByZeroError が発生します。
19    return intdiv($dividend, $divisor);
20}
21
22// --- サンプル使用例 ---
23
24// 通常の整数除算
25$num1 = 10;
26$num2 = 3;
27try {
28    $result1 = calculateIntegerDivision($num1, $num2);
29    echo "{$num1} ÷ {$num2} (整数除算) = " . $result1 . PHP_EOL; // 出力: 3
30} catch (DivisionByZeroError $e) {
31    echo "エラー: " . $e->getMessage() . PHP_EOL;
32}
33
34// 負の数を含む整数除算
35$num3 = -10;
36$num4 = 3;
37try {
38    $result2 = calculateIntegerDivision($num3, $num4);
39    echo "{$num3} ÷ {$num4} (整数除算) = " . $result2 . PHP_EOL; // 出力: -3
40} catch (DivisionByZeroError $e) {
41    echo "エラー: " . $e->getMessage() . PHP_EOL;
42}
43
44// ゼロ除算のケース (DivisionByZeroError が発生する)
45$num5 = 10;
46$num6 = 0;
47try {
48    $result3 = calculateIntegerDivision($num5, $num6);
49    echo "{$num5} ÷ {$num6} (整数除算) = " . $result3 . PHP_EOL;
50} catch (DivisionByZeroError $e) {
51    echo "エラー: ゼロで割ることはできません。 " . $e->getMessage() . PHP_EOL;
52}
53
54// リファレンス情報で提供された定数 ENT_DISALLOWED は、
55// htmlspecialchars() や htmlentities() 関数で使用されるエンティティ定数であり、
56// intdiv() 関数とは直接的な関連性がないため、このコード例には含めていません。
57// (PHP 8.1 で非推奨、PHP 9.0 で削除予定の定数です。)

このPHPコードは、intdiv()関数を用いた整数除算の実行方法を解説しています。intdiv()関数は、2つの数値を割り算した結果の整数部分のみを返します。この関数は、小数点以下を常に切り捨てるため、例えば10を3で割ると3を、-10を3で割ると-3を返します。

calculateIntegerDivision関数は、整数型の$dividend（被除数）と$divisor（除数）を引数として受け取り、intdiv()関数で計算した整数結果をint型で返します。注意点として、除数$divisorに0を指定すると、DivisionByZeroErrorというエラーが発生します。そのため、ゼロ除算の可能性がある場合は、try-catchブロックを使用してエラーを捕捉し、プログラムが予期せず停止しないよう適切に処理することが重要です。

サンプルコードでは、10 ÷ 3 や -10 ÷ 3 といった通常の整数除算の結果に加え、除数に0を指定した場合のエラー処理が具体的に示されており、intdiv()関数の基本的な動作と、堅牢なコードを記述するためのエラーハンドリングの実践的な方法を学ぶことができます。