Difference between revisions of "PHP/enum"
< PHP
Jump to navigation
Jump to search
Line 32: | Line 32: | ||
| static function || [https://www.php.net/manual/en/unitenum.cases.php cases]<syntaxhighlight lang=php inline>()</syntaxhighlight> || array || {{l/php/native|UnitEnum}} | | static function || [https://www.php.net/manual/en/unitenum.cases.php cases]<syntaxhighlight lang=php inline>()</syntaxhighlight> || array || {{l/php/native|UnitEnum}} | ||
|- | |- | ||
− | | static function | + | | static function || [https://www.php.net/manual/en/backedenum.tryfrom.php tryFrom]<syntaxhighlight lang=php inline>(int|string $value)</syntaxhighlight> || ?static || {{l/php/native|BackedEnum}} || same as <code>from()</code>, but returns NULL if not found (instead of erroring) |
|- | |- | ||
− | | static function | + | | static function || [https://www.php.net/manual/en/backedenum.from.php from]<syntaxhighlight lang=php inline>(int|string $value)</syntaxhighlight> || static || {{l/php/native|BackedEnum}} || same as <code>tryFrom</code>, but throws an error if not found |
|- | |- | ||
− | | dynamic property || $name || string || | + | | dynamic property || $name || string || {{l/php/native|UnitEnum}} || the name of the case (case-sensitive) |
|- | |- | ||
− | | dynamic property || $value || int or string || | + | | dynamic property || $value || int or string || {{l/php/native|BackedEnum}} || the value of the case |
|} | |} | ||
+ | |||
==Documentation== | ==Documentation== | ||
Note that enums can be cast directly to arrays. | Note that enums can be cast directly to arrays. |
Latest revision as of 13:34, 12 May 2025
PHP enum support
|
Examples
"Basic" enum | "Backed" enum |
---|---|
enum Suit
{
case Hearts;
case Diamonds;
case Clubs;
case Spades;
}
|
enum Suit: string
{
case Hearts = 'H';
case Diamonds = 'D';
case Clubs = 'C';
case Spades = 'S';
}
|
Methods
kind of thing | name & args | returns | defined in | description |
---|---|---|---|---|
static function | cases() |
array | UnitEnum
| |
static function | tryFrom(int|string $value) |
?static | BackedEnum |
same as from() , but returns NULL if not found (instead of erroring)
|
static function | from(int|string $value) |
static | BackedEnum |
same as tryFrom , but throws an error if not found
|
dynamic property | $name | string | UnitEnum |
the name of the case (case-sensitive) |
dynamic property | $value | int or string | BackedEnum |
the value of the case |
Documentation
Note that enums can be cast directly to arrays.
- Enumerations:
- Classoids:
3rd party
Sample Code
To get a UnitEnum enum from a case name (equivalent to from()/tryFrom()):
- constant("<enum name>::{$value}")
Tests
- is an
enum
an object (is_object
)? [YES] - is an
enum
seen asis_a UnitEnum
? [YES] - is an
enum
aninstanceof UnitEnum
? [YES] - is an
enum
aninstanceof enum
? [no]