【PHP8.x】Random\IntervalBoundary::ClosedClosed定数の使い方

Copy
1<?php
2
3use Random\Randomizer;
4use Random\IntervalBoundary;
5
6/**
7 * RandomNumberGenerator クラスは、PHP 8 の Random 拡張機能を使用して乱数を生成します。
8 * Random\IntervalBoundary::ClosedClosed 定数を使用し、乱数の範囲が両端を含むように指定します。
9 */
10class RandomNumberGenerator
11{
12    private Randomizer $randomizer;
13
14    /**
15     * コンストラクタで Randomizer のインスタンスを初期化します。
16     */
17    public function __construct()
18    {
19        $this->randomizer = new Randomizer();
20    }
21
22    /**
23     * 指定された閉区間 [min, max] 内でランダムな整数を生成します。
24     *
25     * @param int $min 最小値（含む）
26     * @param int $max 最大値（含む）
27     * @return int 生成されたランダムな整数
28     */
29    public function generateClosedClosedInt(int $min, int $max): int
30    {
31        // Random\IntervalBoundary::ClosedClosed は、乱数の範囲が最小値と最大値の両方を含むことを保証します。
32        return $this->randomizer->getInt($min, $max, IntervalBoundary::ClosedClosed);
33    }
34
35    /**
36     * リソースを「閉じる」操作をシミュレートするメソッド。
37     * Randomizer オブジェクトは通常、明示的なリソース解放（close）を必要としません。
38     * このメソッドは、「php close()」というキーワードの概念を示すために含まれています。
39     */
40    public function close(): void
41    {
42        // Randomizer オブジェクトはファイルハンドルやデータベース接続のように明示的に閉じるべきリソースを保持しません。
43        // ここでは、リソース管理における「閉じる」という概念のデモンストレーションとして機能します。
44        echo "Note: Randomizer does not typically require explicit 'close' operations. This demonstrates the concept.\n";
45    }
46}
47
48// 使用例
49$generator = new RandomNumberGenerator();
50
51// 1から10までの閉区間（1と10を含む）で乱数を生成
52$randomNumber = $generator->generateClosedClosedInt(1, 10);
53echo "Generated random number (interval [1, 10] inclusive): " . $randomNumber . "\n";
54
55// 「php close()」キーワードに対応する close メソッドの呼び出し
56$generator->close();

このサンプルコードは、PHP 8で導入された新しい乱数生成機能と、その範囲指定に使われるRandom\IntervalBoundary::ClosedClosed定数の使用方法を示しています。Random\IntervalBoundary::ClosedClosed定数は、乱数を生成する際、指定された最小値と最大値の両方を含む「閉区間」で乱数を生成するように指示するものです。

RandomNumberGeneratorクラスのgenerateClosedClosedIntメソッドは、引数として渡された$min（最小値）と$max（最大値）の範囲内で、両端を含むランダムな整数を生成します。このメソッドは、生成された整数を戻り値として返します。内部ではRandomizerオブジェクトのgetIntメソッドを使用し、IntervalBoundary::ClosedClosed定数を指定することで、厳密な閉区間での乱数生成が保証されます。

また、コードに含まれるcloseメソッドは、「php close()」というキーワードに関連するリソース管理の概念を説明するために用意されています。Randomizerオブジェクト自体は、ファイルハンドルやデータベース接続のように明示的に「閉じる」ことでリソースを解放する必要が通常はありません。しかし、このcloseメソッドは、リソースを使い終わった後に適切に解放するという、プログラミングにおける一般的なプラクティスのデモンストレーションとして機能します。このメソッドには引数がなく、戻り値もありません。コードの最後では、生成された乱数の表示と、closeメソッドの呼び出し例が示されています。

Copy
1<?php
2
3// このサンプルコードはPHP 8.3以降で動作します。
4// 指定されたリファレンス情報 `Random\IntervalBoundary::ClosedClosed` はPHP 8.3で導入されました。
5// PHPのクロージャ（匿名関数）の基本的な使い方と、外部変数のキャプチャ、
6// そして特定の定数（Enumケース）の利用例を示します。
7
8use Random\IntervalBoundary;
9use Random\Randomizer;
10
11/**
12 * PHPのクロージャ（匿名関数）と、Random\IntervalBoundary::ClosedClosed 定数の
13 * 利用例を示す関数です。
14 *
15 * システムエンジニアを目指す初心者向けに、クロージャの基本的な概念と、
16 * 外部変数をキャプチャする `use` キーワードの働きを理解しやすいように構成しています。
17 * また、PHP 8.3で導入された新しいRandom拡張の定数も組み込んでいます。
18 *
19 * @param string $initialMessage 最初に表示するメッセージの接頭辞
20 * @return void
21 */
22function demonstrateClosureUsageWithRandomConstant(string $initialMessage): void
23{
24    // 1. 外部変数を定義します。
25    // これらの変数は、後で定義するクロージャによってキャプチャされます。
26    $appName = "PHP Demo App";
27    $minValue = 10;
28    $maxValue = 20;
29
30    // 2. 指定されたリファレンス情報から、Random\IntervalBoundary::ClosedClosed を使用します。
31    // これはEnumのケースであり、乱数生成の境界条件（閉区間）を示します。
32    $boundaryCondition = IntervalBoundary::ClosedClosed;
33
34    echo $initialMessage . "\n";
35    echo "----------------------------------------\n";
36
37    // 3. クロージャ（匿名関数）を定義します。
38    // `use` キーワードを使って、$appName, $minValue, $maxValue, $boundaryCondition
39    // といった外部変数をクロージャのスコープに取り込みます。
40    // クロージャは、定義された時点のこれらの変数の値を「記憶」します（デフォルトでは値渡し）。
41    $generateAndDisplayRandomNumber = function (string $userName) use (
42        $appName,
43        $minValue,
44        $maxValue,
45        $boundaryCondition
46    ): void {
47        echo "ようこそ、" . $userName . "さん！(" . $appName . "より)\n";
48
49        // Randomizerを使って、指定された境界条件で乱数を生成します。
50        // `IntervalBoundary::ClosedClosed` は閉区間（両端を含む）を示します。
51        try {
52            $randomizer = new Randomizer();
53            // $minValue から $maxValue までの閉区間で乱数を生成します。
54            $randomNumber = $randomizer->getInt($minValue, $maxValue, $boundaryCondition);
55            echo "生成された乱数 (閉区間 [" . $minValue . ", " . $maxValue . "]): " . $randomNumber . "\n";
56            echo "使用された境界タイプ: " . $boundaryCondition->name . "\n";
57        } catch (\Throwable $e) {
58            // PHP 8.3未満の環境では Randomizer や IntervalBoundary が存在しないため、
59            // ここでエラーをキャッチする可能性があります。
60            echo "乱数生成に失敗しました: " . $e->getMessage() . "\n";
61            echo "ヒント: この機能はPHP 8.3以降で利用可能です。\n";
62        }
63        echo "\n";
64    };
65
66    // 4. 定義したクロージャを複数回実行します。
67    // クロージャは、定義時にキャプチャした外部変数の値を持ち続けています。
68    $generateAndDisplayRandomNumber("田中");
69    $generateAndDisplayRandomNumber("佐藤");
70
71    // 外部変数を変更しても、クロージャが「use」でキャプチャした値は変わりません
72    // (デフォルトでは値渡しのため、クロージャはコピーされた値を使用します)。
73    $appName = "New App Name";
74    echo "外部変数を変更後...\n";
75    $generateAndDisplayRandomNumber("鈴木"); // ここで表示される appName は「PHP Demo App」のままです。
76}
77
78// 関数を呼び出して実行します。
79demonstrateClosureUsageWithRandomConstant("PHP クロージャと定数のデモを開始します。");
80

このPHPサンプルコードは、匿名関数である「クロージャ」の基本的な使い方と、PHP 8.3で導入されたRandom\IntervalBoundary::ClosedClosedという定数の利用方法を示します。

demonstrateClosureUsageWithRandomConstant関数は、$initialMessageを文字列として引数に取り、メッセージを表示して処理を実行するだけの戻り値なし（void）の関数です。この関数内で、$appNameなどの外部変数を定義し、次にRandom\IntervalBoundary::ClosedClosedを$boundaryCondition変数に格納します。この定数（Enumケース）は、乱数を生成する際に「両端を含む」閉区間を指定するために使用され、PHP 8.3以降で利用可能です。

その後、$generateAndDisplayRandomNumberというクロージャを定義します。クロージャは名前のない関数で、useキーワードを使うことで、そのクロージャが定義された時点の$appNameや$minValueといった外部変数の値を「記憶」し、自身のスコープ内で利用できるようになります（デフォルトでは値渡し）。このクロージャは$userNameという文字列を引数に受け取り、乱数生成器Randomizerを使って、記憶した範囲と境界条件に基づき乱数を生成して表示します。このクロージャの戻り値はvoidで何も返しません。

最後に、定義したクロージャを複数回呼び出すことで、一度キャプチャされた外部変数の値がクロージャ内で維持される様子を確認できます。外部変数を変更しても、クロージャがuseでキャプチャした値はデフォルトでは変わらない点が重要です。