Сопоставляет скаляр с экземпляром перечисления

# BackedEnum::from

(PHP 8 >= 8.1.0)

BackedEnum::from — Сопоставляет скаляр с экземпляром перечисления

### Описание

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

Метод from() переводит строку (string) или число (int) в соответствующее значение перечисления, если такое имеется. Если соответствующее значение не определено, выбрасывается ValueError.

### Список параметров

`value`

  Скалярное значение для сопоставления с перечислением.

### Возвращаемые значения

Случайный экземпляр этого перечисления.

### Примеры

Пример #1 Простой пример использования

В следующем примере показано, как возвращаются варианты перечисления.

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

Результат выполнения приведённого примера:

    enum(Suit::Hearts)

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

### Смотрите также

- UnitEnum::cases() - Возвращает список вариантов перечисления
- BackedEnum::tryFrom() - Сопоставляет скаляр с экземпляром перечисления или null

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