L'interface Stringable

    (PHP 8)

    Introduction

    L'interface Stringable désigne une classe possédant une méthode __toString(). Contrairement à la plupart des interfaces, Stringable est implicitement présente sur toute classe pour laquelle la méthode magique __toString() est définie, et ce bien qu'elle puisse et devrait être déclarée explicitement.

    Sa valeur principale est de permettre aux fonctions de vérifier le type par rapport au type d'union string|Stringable pour accepter soit une chaîne de caractères primitive, soit un objet pouvant être transtypé en chaîne de caractères.

    Sommaire de l'Interface

    interface Stringable {
    /* Méthodes */
    public __toString(): string
    }

    Exemples

    Exemple #1 Exemple simple

    <?php
    class IPv4Address implements Stringable {
    public function     __construct(
    private     string $oct1,
    private     string $oct2,
    private     string $oct3,
    private     string $oct4,
    ) {}

    public function     __toString(): string {
    return     "$this->oct1.$this->oct2.$this->oct3.$this->oct4";
    }
    }

    function     showStuff(string|Stringable $value) {
    // Pour un Stringable, cela appellera implicitement __toString().
    print $value;
    }

    $ip = new IPv4Address('123', '234', '42', '9');

    showStuff($ip);
    ?>

    Résultat de l'exemple ci-dessus est similaire à :

    123.234.42.9

    Sommaire

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    39
    Gormack
    2 years ago
    Since it's introduced in PHP 8, IPv4Address class Example #1 could be shortened to:
    <?php
    class IPv4Address implements Stringable {
    public function     __construct(private string $oct1, private string $oct2, private string $oct3, private string $oct4) {
    }

    public function     __toString(): string {
    return     "$this->oct1.$this->oct2.$this->oct3.$this->oct4";
    }
    }
    ?>
    ＋add a note
    To Top