UnitEnum::cases

(PHP 8 >= 8.1.0)

UnitEnum::cases — Возвращает список вариантов перечисления

Описание

public static UnitEnum::cases(): array

Метод возвращает упакованный массив всех вариантов перечисления в порядке объявления.

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

Сигнатура функции не содержит параметров.

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

Массив всех определённых вариантов перечисления в порядке объявления.

Примеры

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

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

<?php
enum Suit
{
    case Hearts;
    case Diamonds;
    case Clubs;
    case Spades;
}

var_dump(Suit::cases());
?>

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

array(4) {
    [0]=>
    enum(Suit::Hearts)
    [1]=>
    enum(Suit::Diamonds)
    [2]=>
    enum(Suit::Clubs)
    [3]=>
    enum(Suit::Spades)
}

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 2 notes

down

avishkasenanayake at hotmail dot com ¶

2 years ago

If anyone is here wondering how to get all the names from the enum cases and map them into an array, it can be done like this:

array_column(CampaignPeriods::cases(), 'name');

Likewise, have the 2nd argument as 'value' to get the enum's values.

Happy coding, web artisan :)

down

miken32 at example dot com ¶

3 days ago

The Enum documentation says, "if a Backed Enum is serialized to JSON, it will be represented by its scalar value only, in the appropriate type."

This means you can easily get a backed Enum's values for use in a JSON document using only the BackedEnum::cases() method:

<?php
enum Suits: string {
    case Hearts = 'Heart';
    case Diamonds = 'Diamond';
    case Clubs = 'Spade';
    case Spades = 'Club';
}
echo json_encode(Suits::cases());
?>

Results in this output:

["Heart","Diamond","Spade","Club"]

＋Добавить