Ds\Set::add

    (PECL ds >= 1.0.0)

    Ds\Set::add — Adds values to the set

    Description

    publicDs\Set::add(mixed...$values): void

    Adds all given values to the set that haven't already been added.

    Note:

    Values of type object are supported. If an object implements Ds\Hashable, equality will be determined by the object's equals function. If an object does not implement Ds\Hashable, objects must be references to the same instance to be considered equal.

    Attention

    All comparisons are strict (type and value).

    Liste de paramètres

    values

    Values to add to the set.

    Valeurs de retour

    Aucune valeur n'est retournée.

    Exemples

    Exemple #1 Ds\Set::add() example using integers

    <?php
    $set     = new \Ds\Set();

    $set->add(1);
    $set->add(1);
    $set->add(2);
    $set->add(3);

    // Strict comparison would not treat these the same as int(1)
    $set->add("1");
    $set->add(true);

    var_dump($set);
    ?>

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

    object(Ds\Set)#1 (5) { [0]=> int(1) [1]=> int(2) [2]=> int(3) [3]=> string(1) "1" [4]=> bool(true) }

    Exemple #2 Ds\Set::add() example using objects

    <?php
    class HashableObject implements \Ds\Hashable
    {

    private $value;

    public function     __construct($value)
    {
    $this->value = $value;
    }

    public function     hash()
    {
    return     $this->value;
    }

    public function     equals($obj): bool
    {
    return     $this->value === $obj->value;
    }
    }

    $set = new \Ds\Set();

    $obj = new \ArrayIterator([]);

    // Adding the same instance multiple times will only add the first.
    $set->add($obj);
    $set->add($obj);

    // Adding multiple instances of the same object will add them all.
    $set->add(new \stdClass());
    $set->add(new \stdClass());

    // Adding multiple instances of equal hashable objects will only add the first.
    $set->add(new \HashableObject(1));
    $set->add(new \HashableObject(1));
    $set->add(new \HashableObject(2));
    $set->add(new \HashableObject(2));

    var_dump($set);
    ?>

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

    object(Ds\Set)#1 (5) { [0]=> object(ArrayIterator)#2 (1) { ["storage":"ArrayIterator":private]=> array(0) { } } [1]=> object(stdClass)#3 (0) { } [2]=> object(stdClass)#4 (0) { } [3]=> object(HashableObject)#5 (1) { ["value":"HashableObject":private]=> int(1) } [4]=> object(HashableObject)#6 (1) { ["value":"HashableObject":private]=> int(2) } }
    To Top