Ds\Map::remove
(PECL ds >= 1.0.0)
Ds\Map::remove — Видаляє та повертає значення за ключом
Опис
public Ds\Map::remove(mixed $key, mixed $default = ?): mixed
Видаляє та повертає значення за ключом, або повертає необов'язкове значення за промовчанням, якщо ключ не знайдено.
Зауваження :
Підтримуються значення типу об'єкта. Якщо об'єкт реалізує інтерфейс Ds\Hashable, перевірка здійснюється шляхом виклику методу об'єкта
equals. Якщо об'єкт не реалізує інтерфейс Ds\Hashable, об'єкти повинні посилатися на той самий екземпляр класу.
Зауваження :
Ви можете використовувати синтаксис масиву для доступу до значень, тобто .
$map["key"]
Застереження
Будьте обережні під час використання синтаксису масиву. Скалярні ключі будуть приведені до всіх двигунів PHP. Наприклад, $map["1"] буде намагатися звернутися до int(1), тогда как$map->get("1") звернеться до правильного елемента.
Смотрите раздел Масиви
Список параметрів
key
Ключ для видалення.
default
Необов'язковий параметр, що встановлює значення, що повертається за замовчуванням, якщо ключ не знайдено.
Значення, що повертаються
Віддалене значення або default, если он указан, а ключkeyне найден.
Помилки
Викидає виняток OutOfRangeException, якщо ключ не знайдено і не встановлено значення за промовчанням.
Приклади
Приклад #1 Приклад використання Ds\Map::remove()****
Висновок наведеного прикладу буде схожим на:
int(1)
int(10)