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

# BackedEnum::tryFrom

(PHP 8 >= 8.1.0)

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

### Описание

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

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

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

`value`

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

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

Экземпляр перечисления или null, если экземпляр не найден.

### Примеры

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

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

    <?php
    enum Suit: string
    {
        case Hearts = 'H';
        case Diamonds = 'D';
        case Clubs = 'C';
        case Spades = 'S';
    }

    $h = Suit::tryFrom('H');

    var_dump($h);

    $b = Suit::tryFrom('B') ?? Suit::Spades;

    var_dump($b);
    ?>

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

    enum(Suit::Hearts)
    enum(Suit::Spades)

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

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

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