【PHP8.x】Random\IntervalBoundary::nameプロパティの使い方

nameプロパティは、所属するRandom\IntervalBoundary列挙型（Enum）の各ケース（列挙子）の名称を文字列として保持するプロパティです。このRandom\IntervalBoundary列挙型は、PHP 8.2で導入されたRandom拡張機能の一部であり、乱数生成において、数値の区間（範囲）の境界がその区間に含まれるべきか（Inclusive）、あるいは含まれるべきではないか（Exclusive）を明確に定義するために使用されます。

具体的に、Random\IntervalBoundary::Inclusiveのような列挙子を参照した場合、そのnameプロパティにアクセスすることで、"Inclusive"という文字列を取得できます。同様に、Random\IntervalBoundary::Exclusiveのnameプロパティからは"Exclusive"という文字列が得られます。このプロパティは、列挙型が提供する限られた選択肢の一つ一つを、その内部の値（valueプロパティ）とは別に、人間が理解しやすい名前で識別する手段を提供します。

nameプロパティから取得できる文字列は、プログラムのデバッグ時やログ出力、あるいはシステム内で現在の状態を示すメッセージを生成する際など、列挙子の名称を文字列として利用したい場面で特に有用です。これにより、列挙型の内部的な値を直接参照するよりも、コードの可読性が向上し、意図しない値の使用によるエラーのリスクを低減することができます。すべてのPHPのEnumインスタンスは、このnameプロパティを持っており、それぞれの列挙子の名前を統一された方法で取得することが可能です。

Copy
1Random\IntervalBoundary::CLOSED->name;

引数なし

引数はありません

string

このプロパティは、区間の境界を表す文字列を返します。例えば、「open」や「closed」といった値になります。