Ds\Map::put

(PECL ds >= 1.0.0)

Ds\Map::put — Встановлення значення за заданим ключем

Опис

public Ds\Map::put(mixed $key, mixed $value): void

Зв'язує ключ keyсо значениемvalueякщо елемент з таким ключем вже існує - його значення перезаписується.

Зауваження :

Підтримуються значення типу об'єкта. Якщо об'єкт реалізує інтерфейс Ds\Hashable, перевірка здійснюється шляхом виклику методу об'єкта equals. Якщо об'єкт не реалізує інтерфейс Ds\Hashable, об'єкти повинні посилатися на той самий екземпляр класу.

Зауваження :

Ви можете використовувати синтаксис масиву для доступу до значень, тобто . $map["key"]

Застереження

Будьте обережні під час використання синтаксису масиву. Скалярні ключі будуть приведені до всіх двигунів PHP. Наприклад, $map["1"] буде намагатися звернутися до int(1), тогда как$map->get("1") звернеться до правильного елемента.

Смотрите раздел Масиви

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

key

Ключ.

value

значення.

Значення, що повертаються

Функція не повертає значення після виконання.

Приклади

Приклад #1 Приклад використання Ds\Map::put()****

Loading...
▶

Висновок наведеного прикладу буде схожим на:

Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => a
            [value] => 1
        )

    [1] => Ds\Pair Object
        (
            [key] => b
            [value] => 2
        )

    [2] => Ds\Pair Object
        (
            [key] => c
            [value] => 3
        )

)

Приклад #2 Приклад використання Ds\Map::put()** з об'єктами як ключі**

Loading...
▶

Висновок наведеного прикладу буде схожим на:

object(Ds\Map)#1 (5) {
  [0]=>
  object(Ds\Pair)#7 (2) {
    ["key"]=>
    object(ArrayIterator)#2 (1) {
      ["storage":"ArrayIterator":private]=>
      array(0) {
      }
    }
    ["value"]=>
    int(2)
  }
  [1]=>
  object(Ds\Pair)#8 (2) {
    ["key"]=>
    object(stdClass)#3 (0) {
    }
    ["value"]=>
    int(3)
  }
  [2]=>
  object(Ds\Pair)#9 (2) {
    ["key"]=>
    object(stdClass)#4 (0) {
    }
    ["value"]=>
    int(4)
  }
  [3]=>
  object(Ds\Pair)#10 (2) {
    ["key"]=>
    object(HashableObject)#5 (1) {
      ["value":"HashableObject":private]=>
      int(1)
    }
    ["value"]=>
    int(6)
  }
  [4]=>
  object(Ds\Pair)#11 (2) {
    ["key"]=>
    object(HashableObject)#6 (1) {
      ["value":"HashableObject":private]=>
      int(2)
    }
    ["value"]=>
    int(8)
  }
}