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() - Сопоставляет скаляр с экземпляром перечисления