BackedEnum::from

(PHP 8 >= 8.1.0)

BackedEnum::from — Mapeia um escalar para uma instância de enumeração

Descrição

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

O método from() traduz uma string ou um int para o caso correspondente do Enum, se houver. Se não houver caso correspondente definido, ele irá emitir um ValueError.

Parâmetros

value

O valor escalar a ser mapeado para um caso de enumeração.

Valor Retornado

Uma instância de caso para esta enumeração.

Exemplos

Example #1 Uso Básico

O exemplo a seguir ilustra como os casos de enumeração são retornados. 

<?php
enum 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');
?>

O exemplo acima produzirá:

enum(Suit::Hearts)

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

Veja Também