BackedEnum::from

(PHP 8 >= 8.1.0)

BackedEnum::fromMaps a scalar to an enum instance

Description

public static BackedEnum::from(int|string $value): static

The from() method translates a string or int into the corresponding Enum case, if any. If there is no matching case defined, it will throw a ValueError.

Parameters

value

The scalar value to map to an enum case.

Return Values

A case instance of this enumeration.

Examples

Example #1 Basic usage

The following example illustrates how enum cases are returned.

<?phpenum Suit: string{    case Hearts = 'H';    case Diamonds = 'D';    case Clubs = 'C';    case Spades = 'S';}$h = Suit::from('H');var_dump($h);$b = Suit::from('B');?>

The above example will output:

enum(Suit::Hearts)

Fatal error: Uncaught ValueError: "B" is not a valid backing value for enum "Suit" in /file.php:15

See Also