Submit a Pull Request Report a Bug

    Класс WeakMap

    (PHP 8)

    Введение

    WeakMap - это коллекция (map) или словарь, который принимает объекты в качестве ключей. Однако, в отличие от аналогичного в остальном SplObjectStorage, объект в ключе WeakMap не влияет на счётчик ссылок объекта. То есть, если в какой-то момент единственной оставшейся ссылкой на объект является ключ WeakMap, объект будет собран сборщиком мусора и удалён из WeakMap. Его основной вариант использования - создание кешей данных, полученных из объекта, которым не нужно жить дольше, чем объект.

    WeakMap реализует ArrayAccess, Iterator и Countable, поэтому в большинстве случаев его можно использовать так же, как ассоциативный массив.

    Обзор классов

    final WeakMap implements Countable , ArrayAccess , IteratorAggregate {
    /* Методы */
    public __construct()
    public count(): int
    abstract public getIterator(): Traversable
    public offsetExists(object $object): bool
    public offsetGet(object $object): mixed
    public offsetSet(object $object, mixed $value): void
    public offsetUnset(object $object): void
    }

    Примеры

    Пример #1 Пример использования Weakmap

    <?php
    $wm     = new WeakMap();

    $o = new StdClass;

    class     A {
        public function     __destruct() {
            echo     "Уничтожено!\n";
        }
    }

    $wm[$o] = new A;

    var_dump(count($wm));
    echo     "Сброс...\n";
    unset(    $o);
    echo     "Готово\n";
    var_dump(count($wm));

    Результат выполнения данного примера:

    int(1)
Сброс...
Уничтожено!
Готово
int(0)

    Содержание

    • WeakMap::__construct — Создаёт новую коллекцию (map)
    • WeakMap::count — Подсчитывает количество живых записей в коллекции (map)
    • WeakMap::getIterator — Получает внешний итератор
    • WeakMap::offsetExists — Проверяет, есть ли в коллекции (map) определённый объект
    • WeakMap::offsetGet — Возвращает значение, на которое указывает определённый объект
    • WeakMap::offsetSet — Обновляет коллекцию (map) новой парой ключ-значение
    • WeakMap::offsetUnset — Удаляет запись из коллекции (map)
    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top