Méthodes d'énumération

Table des matières

Les Enums (à la fois les Enums pures et les Enums supportées) peuvent contenir des méthodes et implémenter des interfaces. Si une Enum implémente une interface, alors toute vérification de type pour cette interface acceptera également tous les cas de cette Enum.

<?php
interface Colorful
{
    public function color(): string;
}

enum Suit implements Colorful
{
    case Hearts;
    case Diamonds;
    case Clubs;
    case Spades;

    // Fulfills the interface contract.
    public function color(): string
    {
        return match($this) {
            Suit::Hearts, Suit::Diamonds => 'Red',
            Suit::Clubs, Suit::Spades => 'Black',
        };
    }

    // Not part of an interface; that's fine.
    public function shape(): string
    {
        return "Rectangle";
    }
}

function paint(Colorful $c) { ... }

paint(Suit::Clubs);  // Works

print Suit::Diamonds->shape(); // prints "Rectangle"
?>

Dans cet exemple, les quatre instances de Suit ont deux méthodes, color() et shape(). En ce qui concerne le code d'appel et les vérifications de type, elles se comportent exactement comme n'importe quelle autre instance d'objet.

Dans le cas d'une Enum soutenue, la déclaration de l'interface suit la déclaration du type de soutien.

<?php
interface Colorful
{
    public function color(): string;
}

enum Suit: string implements Colorful
{
    case Hearts = 'H';
    case Diamonds = 'D';
    case Clubs = 'C';
    case Spades = 'S';

    // Fulfills the interface contract.
    public function color(): string
    {
        return match($this) {
            Suit::Hearts, Suit::Diamonds => 'Red',
            Suit::Clubs, Suit::Spades => 'Black',
        };
    }
}
?>

À l'intérieur d'une méthode, la variable $this est définie et fait référence à l'instance du cas.

Les méthodes peuvent être arbitrairement complexes, mais en pratique, elles renvoient généralement une valeur statique ou match sur $this pour des résultats différents selon les cas.

Il est à noter que dans ce cas, il serait plus judicieux de définir également un type Enum SuitColor avec les valeurs Red et Black et de le renvoyer à la place. Cependant, cela compliquerait cet exemple.

La hiérarchie ci-dessus est logiquement similaire à la structure de classe suivante (bien que ce ne soit pas le code qui s'exécute) :

<?php
interface Colorful
{
    public function color(): string;
}

final class Suit implements UnitEnum, Colorful
{
    public const Hearts = new self('Hearts');
    public const Diamonds = new self('Diamonds');
    public const Clubs = new self('Clubs');
    public const Spades = new self('Spades');

    private function __construct(public readonly string $name) {}

    public function color(): string
    {
        return match($this) {
            Suit::Hearts, Suit::Diamonds => 'Red',
            Suit::Clubs, Suit::Spades => 'Black',
        };
    }

    public function shape(): string
    {
        return "Rectangle";
    }

    public static function cases(): array
    {
        // Méthode illégale, car la définition manuelle d'une méthode cases() sur une énumération n'est pas autorisée. 
        // Voir aussi la section "Liste de valeurs".
    }
}
?>

Les méthodes peuvent être publiques, privées ou protégées, bien qu'en pratique, privées et protégées sont équivalentes car l'héritage n'est pas autorisé.

Rechercher une fonction PHP

Version en cache

06/11/2024 00:58:56 Cette version de la page est en cache (à la date du 06/11/2024 00:58:56) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-language.enumerations.methods.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut