Mapeia um escalar para uma instância de enumeração

# BackedEnum::from

(PHP 8 >= 8.1.0)

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

### Descrição

public static function 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

Exemplo #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

- UnitEnum::cases() - Gera uma lista de casos de uma enumeração
- BackedEnum::tryFrom() - Mapeia um escalar para uma instância de enumeração ou nulo

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open